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Any warranty that may exist on any TRS- 
80 computer hardware product that has 
been modified, altered, or has the seal 
broken is VOID. 

Any software or computer hardware modi- 
fications are done at your own risk. 
Neither the PUBLISHER nor the 
AUTHOR assumes any responsibility or 
liability for loss or damages caused or 
alleged to be caused directly or indirectly 
by applying any modification or alteration 
to software or hardware described in this 
book, including but not limited to any 
interruption of service, loss of business, 
anticipatory profits or consequential 
damages resulting from the use or opera- 
tion of such modified or altered computer 
hardware or software. Also, no patent 
liability is assumed with respect to the use 
of the information contained herein. 
While every precaution has been taken in 
the preparation of this book, the 
PUBLISHER and the AUTHOR assume 
no responsibility for errors or omissions. 

The reader is the sole judge of his or her 
own skill and ability to perform the modi- 
fications and/ or alterations contained in 
this book. 



The below statement is the apparent 
policy of the TANDY CORP. and its 
subsidiary RADIO SHACK as under- 
stood by the publisher. The following 
statement is not endorsed by the TANDY 
CORP., but is presented for the reader's 
information and as a warning regarding 
the consequences of modifying or altering 
the TRS-80 computer hardware in any 
way. IJG, Inc., assumes no responsibility 
for the accuracy of the following statement. 

The reader is warned that it is the apparent 
policy of the TANDY CORP. and its 
subsidiary RADIO SHACK to refuse re- 
pair service on any TRS-80 computer 
product that has been modified or altered 
in any way whatsoever. 

However, a Radio Shack Computer 
Service Center, at the discretion of the 
individual Service Center, may repair an 
altered or modified TRS-80 computer 
upon the customer's prior agreement to 
pay any additional charges that may be 
incurred to remove or repair any and all 
alterations or modifications that may 
exist and thereby return the computer 
hardware to factory specifications. 
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A few years ago, when CB was king, a company 
riding high with those 10-4's hesitantly 
announced a very expensive new product. A few 
typed sheets with hand drawings were all store 
sales personnel had to explain this small 'home 
and business computer'. Neither Tandy nor we 
few first customers had any idea that the TRS-80 
would become the first true home computer, the 
Model T of the microprocessor age. 

There's no question that the 'Trash-80' carries 
the burden of some weak engineering and 
corner-cutting decisions made at the time of the 
CB decline, when this personal computer could 
have been Radio Shack's Waterloo instead of its 
new Wunderkind. But, like Rabelais's 
Gargantua, the new child soon outgrew its 
expectations - as well as its clothes. 

And so everyone from the inner sanctum of the 
Tandy Corporation to the cluttered backrooms 
of a thousand hobbyists began the attempt to 
keep this new child content and amused. Thus 
was born the custom TRS-80. From the very 
beginning, and from seemingly nowhere, came 
forth educated hordes who would prod, poke, 
paint, primp, and prime this humble computer 
into becoming more than itself - a 
five-hundred-dollar supercomputer. 

The machine couldn't always do it. Tandy 
took the rap, but also took the cash. Bruised and 
broken 80's littered the electronic landscape, yet 
also unrecognizably modified TRS-things took 
on tasks as diverse as business accounting, 
industrial control, and music making. 

In this book, pathways to creating your own 
customized TRS-80 will be explored. The 
machine will be added to, opened and altered, its 
software patched, its uses expanded, and its 
breakdowns cured. If you expect that your 
personal computer can do more than a fancy 
game of video violence, then I hope you will join 
me in these explorations. 

As this book was completed, Tandy announced 
that the TRS-80 - now called the Model I - is 
history. Production has ended, and that's a good 



thing. The pressure is now off; there is no more 
Trash-80 to defend, but there still is a TRS-80 to 
put to use. 

This book has been put together to please 
everyone. Of course it will not. Although I can't 
expect to help lead each of you through the 
intricacies of a TRS-80, 1 hope that, whether your 
wish is to jump right in and solder every wire or to 
learn slowly and deliberately the theory and 
practice of the machine, you can gain some 
insight from this volume. 

Chapters have been arranged with basic theory 
and concepts toward the front. Special sections 
discussing the computer's software have been 
included to add some dimension to the concepts, 
and some of my own opinions, thoughts and 
tirades have been boxed throughout the text. 

I have seen and used nearly all the commercial 
products presented in this book; comments, 
therefore, are based on first-hand knowledge, 
unless otherwise noted. 

I have attempted in the appendices to present 
lists of those suppliers, publishers, terms, etc., 
that every TRS-80 user might want to know and 
not know how to find. 

As the TRS-80 joins the computer museum 
along with the ENIAC, UNIVAC, IBM 370, and 
others, it still holds a more special place than 
many of those - with possibly half of million of its 
kin in use in the United States, Canada, Great 
Britain, Australia, Germany, and other 
countries. With that in mind, this book may need 
an occasional update. 

I would appreciate receiving updated 
information, corrections, suggestions and 
criticism. Though I cannot promise a personal 
answer, those suggestions will be reflected in 
future printings of this book. 

Dennis Bathory Kitsz 

Roxbury, Vermont 
February 1981 
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Introduction 



The Tools You Will Need 

Your basic TRS-80, with some attachments 
and software, is a thousand-dollar item. So I'll 
not encourage you to use dime-store tools. Buy 
the best you can afford, keep them clean, and 
reserve them just for use on the '80. Don't double 
up tools with the family auto. You may not need 
them all, but here is my customizer's toolbox: 

A medium-sized flat-blade screwdriver 

and Phillips blade screwdriver (a 
reversible combination is ideal). With 
these you open cases and remove cabinets. 

A jeweler's set of flat and Phillips blade 
screwdrivers; hex nut drivers are optional. 
These drivers can be used to align tape 
heads, help make delicate wire bends, 
adjust trimmer controls and even repair 
watches. 

One very thin screwdriver for lifting 
integrated circuits out of sockets. This will 
be its only purpose, but the first time you 
break the pins off a $10 jumper cable, you'll 
wish you'd used it! 

Small scissor-type cutters (manicuring 
types are excellent). These will be used for 
snipping leads in tight spots. 

Small diagonal wire cutters and/or front- 
cutting 'nippers'. Your general purpose 
cutters. They are fast and easy to use, but 
not to be used for heavy wire around the 
house. 

Needlenose pliers (two pairs, normal and 
90-degree types). You'll need these for 
bending leads, also extracting bits and pieces 
you've dropped into a nest of wiring. 



An X-acto type knife, with a strong blade 
and handle you feel comfortable with. Since 
this will be used to cut delicate solder traces, 
you should be able to handle it deftly. I use 
a single edged razor blade, but have leather 
fingers! 

A scalpel, if you can get one. For very 
delicate trimming and scraping; a dental 
pick for pulling off solder balls or lifting 
parts off a board (get this item from an 
obliging dentist — they are often discarded 
when worn); tweezers and needlepoint 
hooks. The latter come in handy for 
tracing incorrect wire-wrapped 
connections. 

Hat-tail, triangular, and flat files. These 
are only for sprucing up the cosmetics, so if 
you don't care how it looks, save a few 
bucks. 

A wire-wrapping tool. The decision on 
this can be tough. If you can afford it, get 
one of the electrically operated slit-and- 
wrap types. Stay away from 'just wrap' 
tools, since they depend on the sharpness 
and quality of the sockets; also they are 
useless for wrapping capacitors or resistors. 
I use a simple double-ended tool sold by 
Radio Shack for about $5. It wears out 
after a thousand or so connections, but it 
fits my hand well, and is not clumsy like 
some electric units. 

A soldering iron. The decision is not easy. 
Should you spend top dollar and get an 
expensive one or buy a cheap unit that can 
be discarded when it wears out? I use a $5 
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The Tools You Will Need 



To help you prepare for each project, the 
following graphic symbols have been used as a 
key to the tools needed for each project: 






Phillips screwdriver 



Flat-blade screwdriver 



Sockets 







Thin lifting tool 



Scissors type cutters 



Solder 



Wire cutters 



Needlenose pliers 



soldering iron which can be junked when it 
gets beat, but my editor uses the best he 
can get (a $30 temperature-controlled one). 

I file a set of $1 tips to my satisfaction, and 
lubricate the threads with white heat sink 
grease. This way I have a few different tips 
at my disposal; with plated bits you never 
file the tips. 

A Multimeter. The voltage regulators in 
your TRS-80 are very good, so any 
problems will usually show up as gross 
errors. This offers you a way out of buying 
an expensive multimeter; for most of these 
projects, the $10 pocket variety will suffice. 
However, for lots of repair work a better 
meter is in order; I use a $40 type (not 
digital!) for my work. 

An oscilloscope. For the projects, no. But 
for repairs, yes. Don't panic thinking of a 
thousand dollars for a digital scope, 
because an old color television scope will do 
perfectly well; they can be found in the 
bargain bins for $50 to $100. If it saves you 










Various files 



Wire wrapping tool 



Soldering iron 



X-acto knife or blade 



Solder wick 



Multimeter 



Oscilloscope 



Drill 



a $100 repair bill, you've paid for it. Mine 
is an old RCA type WO-90Q, built for early 
color TV, and just fine for the bulk of TRS- 
80 work. 

You will also need supplies in the tool box. 
Among these are: 

Solder. Get the best you can afford. 
There's nothing so unpleasant as a great 
glob of the stuff between two traces on a 
board. Order the multicore rosin flux type, 
and stay away from most the off-the-shelf 
stuff. Remember, multicore rosin type 
only, and the finer the gauge the better. 
Never use acid flux solder, as used by 
plumbers and electricians. 

Soldering wick. Marketed under the 
names Spirig, Solder Up and Solder Wick, 
it's a copper braid impregnated with 
soldering flux. When heated with the 
soldering iron it absorbs Solder off the 
board, thus freeing components. Don't do 
without this stuff unless you like fried 
circuit boards and burnt fingers. 
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Wirewrap wire. Also called by the trade 
name Kynar, this is 28- or 30-gauge single- 
strand wire used to interconnect the pins of 
wire wrap sockets. It comes in an 
assortment of colors; get them all, so you 
can keep data, address, power and ground 
lines separate. 

Multiconductor cable. The more flexible 
wire is easier on the coordination, but also 
the most expensive. Best buy is Spectra 
Twist, and its kin, from surplus houses. If 
you need jumper cables, buy them; Making 
a two-ended, 40-pin jumper cable can be 
three hours of maddening work. 

Bus wire. This is solid, uninsulated stuff. 
A small roll will do for a lifetime. I use it 
for wiring, securing bulky capacitors to 
circuit boards, holding bundles of things 
together and for making special tools. 

Miscellaneous. Sockets, perforated board, 
mounting hardware, and such will always 
be needed. 

Details about supplies needed for each project 
in this book will be presented with the project. 
Except for integrated circuits, most of the items 
are available right off the shelf at a local Radio 
Shack or other electronics supply house. 

Schematics 

Schematic drawings of electronic circuits are 
identical to maps. They show routes, direction, 
junctions, relative importance and functions of 
locales, two-way and one-way streets, traffic flow 
and congestion and so forth. At first, the symbols 
may seem like the mysterious hieroglyphics of a 
secret society, but their symbolism can soon 
become as familiar as a roadmap. Even strange 
places can be assessed from afar. 

First, the symbols. A line is a wire running 
from some point in the circuit to another. 
Consider the sketches below: 



A #= 



-9 












The first drawing is a simple wire. The 
electrical path moves from one point to another, 
in either direction. By following the path of a 
wire through a circuit, the pattern of connections 
can be discovered. When wires are forced to cross 
one another, but not to connect with each other, 
it must be made clear. On a roadmap, 
non-intersecting roads are shown either by a 
break in one of the intersecting lines, or in 
showing interstate highways, merely by crossing 
one 'below' the other in a different color. 

Sketches b, c and d are the three ways of 
drawing wires which do not connect to each 
other. The first, simply crossing them, is the 
most common. The second method places a 
semicircular bump in the crossing path, and is 
used by Sams Publications in this country and 
commonly in Europe. Occasionally the broken 
path crossing shown in sketch d is used. 

When wires connect, a dot is used to clarify 
that a connection is to be made. Occasionally, 
you may come across earlier schematics which 
use the 'bump' method of showing unconnected 
wires. On these schematics, the lack of a bump 
indicates wires are connected. 

The wires (or patterns of copper etched on 
circuit boards) connect electronic components. 
Some of them are: 



RESISTOR 



CAPACITORS 




_L+_L 

T" T POLARIZED 



DIODE 



FET TRANSISTOR 

Since this is a lesson in reading schematics and 
not electronic theory, I recommend that you turn 
to an excellent book by Forrest Mims, 
'Engineer's Notebook', sold by Radio Shack, for 
an introduction to what each of these parts does. 
Briefly, the symbol for a resistor has the flavor of 
a long wire being compressed, meaning the 
electrical flow is somehow being resisted. The 
innards of a capacitor generally consist of metal 
foil separated by a non-conducting paper or 
plastic, and the capacitor's schematic symbol is 
fairly representative, with two plates facing each 
other but not joining. 
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Some capacitors are designed to fit into a 
circuit in only one direction; the positive (+) sign 
identifies that direction. These capacitors are 
identified on their bodies by a positive or 
negative sign. Another one direction (polarized) 
device is the diode. It consists of an arrowhead 
striking a barrier, implying that current may flow 
in the direction of the arrowhead, but not back 
across the plate. The body of a diode may have 
the diode symbol imprinted on it, or a band to 
indicate the 'barrier' end. 

The transistor usually has three connections 
(such connections are called 'leads' on small 
parts such as these). These leads are identified as 
collector, base and emitter or source, gate and 
drain, depending on the transistor type. This will 
be shown on the diagram, and the transistor will 
be imprinted with the information, or it will be 
provided on the package in which the transistor 
is sold. 

A few other symbols are: 



TRANSFORMER 



-ytk- 



VARIABLE RESISTORS 



y 



-wv 



Q' 



CRYSTAL 
VARIABLE CAPACITORS 

The first is a transformer, whose job it is to 
take current fed into one coil and induce that 
current into a second coil. An iron or ferrite 
center (the parallel lines in the symbol) aids in 
efficient transfer of that current. 

The next three symbols look like resistors and 
capacitors, which they are. The added arrows 
show that their values may be varied; hence, they 
are called variable resistors and variable 
capacitors. The variable resistor is best known as 
the volume control on a television, and the 
variable capacitor is found as the tuning control 
on a table radio. 

The last symbol is a crystal, a piece of cut 
quartz capable of vibrating (resonating) under 
certain electrical conditions. Because a crystal is 
a very accurate, fixed, molecular device, it is 
capable of resonating (also called oscillating) at 



precise intervals. It is used for the master control 
of all pulses in the TRS-80. 

A few directional symbols are now in order: 
GROUNDS 



i i i 

EARTH CHASSIS COMMON 
POWER . ,. 



t 



<3 



\ 



PAD 



The first are known as grounds, and they are 
used to indicate a potential of zero or neutral 
voltage. The first of the trio is an earth ground, 
commonly used in radio, television and hi-fi 
schematics, but purists use it only to describe an 
actual connection to a ground spike or cold water 
pipe. The second is a chassis ground, indicating 
an electrical connection to the metal case which 
encloses the circuit. It is often (though 
incorrectly) interchanged with the earth ground. 

The last of the three grounds is a 'common' or 
neutral ground, and the one which is used to 
indicate the zero voltage line in the computer. 
All other voltages within the computer system 
are described in terms of their relation to this 
ground. 

The next quartet of symbols indicate power. 
The up arrow generally points to an actual 
voltage value (such as +5 or +12).The horizontal 
line indicates merely a 'high' level, that is, a 
connection is made to the normal positive power 
supply for the circuits in the system (+5 volts in 
the TRS-80). 

Non-positive voltages have no standard 
symbols. Negative (or below ground) voltages 
can have either a horizontal arrow or a down 
arrow, pointing to the voltage desired at that 
point. The schematics tells you that a connection 
is made to the voltage level shown! 

Another use of a horizontal arrow is to point to 
important connections to be made elsewhere on 
the schematic or on other sheets of the schematic. 
In the former case, the arrow is used because 
actually drawing the wire may clutter the 
schematic, making it illegible. When you see an 
arrow, be sure to find the other end of the 
connection described (indicating words such as 
'clock', 'mem' or 'port FF' may be used as guides 
to where the connection is made). 
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Another useful symbol is the last of the group 
above, the pad. It indicates a significant 
connection, usually to another device or circuit 
board. Using this symbol makes it clear that the 
connection is to be made somewhere off the 
board on which you are working. In this book, I 
have not used these symbols where indicating a 
connection to the TRS-80; instead, the cable to 
the TRS-80 is shown with the connecting wires 
striking a wide vertical band marked 'TRS-80 
Edge Connector'. Other types of off-board 
connections, however, are shown with the pads. 

The most common families of parts found in 
computer circuits, however, are shown below: 



o — 



€> 



AND 



OR 



o- 
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NAND 



BUFFER [a) 



NOR 
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lb} 



> 



INVERTER 

These symbols represent integrated circuits, 
those multiple lead, buglike packages that 
handle the bulk of the work in the computer. 
Briefly, these are logical building blocks. 
Sometimes there are several blocks in one 
integrated circuit, and these various blocks may 
be scattered throughout the circuit diagram. 
This can be confusing when actually building a 
circuit, but since pin (lead) numbers are given, 
you only have to remember where you put the 
part. 

You should know that the TRS-80 Technical 
Reference Handbook uses what are called 
'functional' schematic elements, meaning 
identical parts are not necessarily drawn the 
same throughout the schematic. I have chosen 
not to use this method, which, although it makes 
circuit operation less evident, is clearer when 
doing actual wiring. 

Complete logical and physical diagrams of 
every circuit used in this book are give in an 
appendix. Those diagrams will help give you an 
idea of how these logical blocks are packaged 
inside 8-, 14-, 16-, 18-, 20-, 24-, 28- and 40-pin 
cases. 



Basically, that covers reading a schematic 
roadmap. Below is a section of circuit. See how 
the logic elements are connected to each other as 
well as to two resistors, a capacitor and a crystal. 
Notice also that the logic elements are all marked 
'Z19\ since they are separate blocks within a 
single component. An arrowhead indicates a wire 
leading off the board, and power and ground 
connections are shown. The numbers on the logic 
elements are the pin numbers for the component 
connections: 
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910 
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R52 
910 
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TOGGLE 



+ 5V 
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CLOCK 
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Be Tolerant 

Every electronic component is manufactured 
to work within specific limits, whether they be 
accuracy, temperature, speed, power use or other 
limit. These are the components parameters or 
tolerances. The circuits in this book have been 
designed to use the most commonly available 
parts, so the matter of tolerances is rarely 
important. However, sometimes those 
tolerances are important, such as when talking 
about memory speed or power supply voltages. 

Power supply should be within five percent of 
the voltage specified; a supply indicated at five 
volts may vary only from 4.5 volts to 5.5 volts. By 
using the power supply regulators shown in the 
schematics, these voltages should not be of 
concern. Unless you are familiar with power 
supply design, do not attempt to use other 
methods of regulation. 

Very few of the resistors have tolerances noted 
on the schematics. The rule of thumb is one 
quarter watt at five percent, but if you can only 
obtain half watt units, or 10 or 20 percent 
resistors, don't be concerned. The quarter watt 
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resistors are a bit less costly and are a bit more 
aesthetically appealing. Consider also that if a 
resistor is specified as 1,000 ohms, a 20 percent 
deviation gives a range of 800 ohms to 1,200 
ohms. Thus, the standard values of 910 ohms or 
1,200 ohms should do as well. 

Capacitors are notoriously sloppy in their 
tolerances, especially electrolytic types (those 
whose polarity is marked on the schematics). 
These normally vary from 20 percent low to more 
than 100 percent high - thus, when a 500 
microfarad capacitor is noted, it can range from 
400 to 1,000 microfarads. Also, there is some 
revision in the standard numbering method used 
for parts values: 470 microfarads is now being 
called 500 microfarads, for example. So when 
you try to obtain a capacitor value marked in the 
parts list, remember that a nearby higher value is 
fine. 

Voltage parameters for polarized (electrolytic) 
capacitors are important. Never get an 
electrolytic capacitor with a value less than that 
specified, but do not hesitate to take one with a 
higher voltage parameter. That is, a capacitor 
specified at 47 microfarads, 16 volts, can be 
replaced with one specified at 50 microfarads, 35 
volts. It may be physically larger, but it will work 
equally well. 

If you walk into a store and hand the sales clerk 
a parts list, don't be surprised if you are asked a 
few more questions. You might be faced with 
chosing between parts which are identical as far 
as the parts list in this book is concerned, but 
which include other parameters. 

Resistors can be carbon composition, carbon 
film, glass or wire wound. These days, carbon 
film is common and cheap, and that's your first 
choice. Carbon composition is the next choice at 
a lower quality, and glass is excellent but at a 
higher cost. Forget wire wound, because they can 
contribute unwanted side effects. 

Ordinary capacitors are manufactured in 
many ways: ceramic, polystyrene, polyester, 
silver mica, polycarbonate and paper. For the 
bypass capacitors necessary for all the circuits in 
this book, ceramic types are your choice. Cheap. 
If you get silver mica, so much the better, but 
you'll pay a price. Watch out for polystryrenes or 
polyesters if you plan to solder, because they are 
delicate and you can damage them with too much 
heat. Otherwise they are excellent, but quality 
overkill. Polycarbonates are slick types, and you 
might consider using these if you build the 
8-track mass storage system. Run the other way 
if you see paper capacitors. 



Electrolytic capacitors come in two basic types 
- metal cans (covered with plastic), and those 
manufactured using tantalum (an expensive 
metal of great strength and purity). For most 
digital projects, choose the ordinary cans. 
Tantalums of the same value, although smaller, 
high quality, and very pert looking, are costly and 
not required here. 

Digital integrated circuit part numbers are 
generic, which means that a 74LS00 circuit might 
be sold as an SN74LS00 or an NEC-74LS00. The 
prefix characters refer to manufacturers. On the 
other hand, those parts whose numbers contain 
'LS' may not be substituted by parts marked 'S' 
or 'C or by those with no markings. 74LS00 may 
not be replaced by 7400, 74S00, or 74C00, nor 
may they be exchanged for each other. When 
integrated circuits are specified, try not to 
substitute with other circuit 'families'. 

This section will not make you a master 
schematic reader; only practice will do that. Pick 
up copies of the Engineer's Notebook mentioned 
above, as well as various of the project books sold 
by Radio Shack and others. 

Building a Power Supply 

All the projects presented in this book will 
either be modifications to the TRS-80, in which 
case they will draw power from the computer 
itself, or outboard devices which will need power. 
There are several ways to get this power: 

1. Build a power supply from scratch for 
each device, including transformer, rectifiers, 
capacitors and regulators. 

2. Build a main power supply providing 
substantial current at between 7.5 and 15 
volts, and put a voltage regulator and a 
capacitor on board each project. 

3. Use an assembled power supply providing 
a 7.5 to 9 volt output for each project, and 
use a voltage regulator and a capacitor on 
each board. 

4. Use an assembled power supply providing 
5 volts and feed all boards from it. 

My recommendation? Probably an assembled 
power supply of 7.5 to 9 volts feeding each 
project. Power supplies are important to 
projects, and they should be well regulated, free 
of residual 60 Hz (Hertz equals 'cycles per 
second)' ripple, and should not tend to transmit 
signals between projects. Some things to 
consider include: 
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Unregulated positive power supply. 



1. Building a power supply is not very 
time-consuming, but it is probably going to 
be bulkier than the project being 
constructed. Then there's the question of 
where do you put it? If it's in the project, 
you have to be very careful to shield the AC 
primary and secondary leads. Also, you have 
to be sure it's working properly before you 
can begin to test your project. 
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Unregulated bipolar power supply. 
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2. Small, assembled power supplies are 
inexpensive. They are normally sold as 
'battery eliminators', with their current 
capabilities specified. The AC leads are 
encapsulated in plastic with the rest of the 
supply. Although you need a separate 
house-current outlet for each of these 
supplies, the work you do (both building and 
testing) is lessened and the safety to you and 
your project is increased. 

3. Larger power supplies are expensive to 
buy and complicated to build. Unless they 
and each project being fed contain plenty of 
transient suppression (in other words, lots of 
extra capacitors), the actions of one device 
may affect another. But they do tend to be 
more immune to house current fluctuations 
than small homemade or purchased power 
supplies. With regulators on each project, 
moreover, you can provide more immunity to 
spikes and fluctuations. They are truly 
'brute force' circuits. 

4. Large regulated power supplies are highly 
stable, but expensive. They are capable of 
feeding a whole range of boards, less house 
current outlets are needed, and the level of 
regulation is usually substantial enough to 
prevent fluctuations at the board level. 
However, onboard filtering is still necessary 
to prevent interaction among external 
devices. 

The circuit diagrams that follow present a 
simple, unregulated, positive power supply; a 
simple, unregulated, bipolar power supply; a 
regulated five-volt power supply; a regulated 
dual-voltage (+5 and +12 volts) power supply; a 
regulated bipolar (+5 and -5 volts) power supply; 
a regulated four-voltage (+12, +5, -5 and -12 
volts) supply, and last (but by no means least) 
the design of the power supply (+12, +5, and -5 
volts) used in the TRS-80. All these supplies can 
use the transformer / rectifier 'power supply' sold 
for the TRS-80 as their source. 
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Power Suppies 

Digital electronic circuits constructed by hand 
can perform as well as neatly-laid-out 
commercial circuits. In some ways, though, 
these circuits have to be designed better than 
commercial ones, because professionally etched 
boards are usually designed with careful 
consideration given to signal paths. Wire- 
wrapping or soldering, on the other hand, can 
look like a rat's nest and sometimes act that 
way. 

Most important: always use bypass 
capacitors in your projects. These are capacitors 
with a value of about 100 nanofarads (0.1 
microfarads), ceramic discs or dipped mylar, 
attached between +5 volts and ground. These 
are physically placed near their respective 
integrated circuits. When I finish wire wrapping 
a circuit, I give it a quick test to make sure the 
wires are connected properly and the circuit 
behaves normally (barring occasional crashes). 
Then I attach a 100-nanofarad bypass capacitor 
between the positive power supply and ground, 
directly between the wire-wrap pins carrying the 
power. 

Secondly: add termination resistors to the 
data lines whenever more than one project is 
connected to the computer. Termination 
resistors act as electronic clamps, holding the 



10.00QUF 
35V 



10.00QPF 
35V 



+/-12, +/-5 volt regulated power supply. 



lines steady as the signals sweep through. These 
eliminate random noise, as well as signal 
'overshoot', caused by capacitance introduced 
by the wires themselves. If you have an 
expansion interface of the new breed (no 
buffered cable), termination resistors are 
already in place. They are also standard with 
the LNW and Microtek interfaces (though I 
recommend doubling the value suggested by 
LNW, to at least 470 ohms and 1,000 ohms). 

The simplest addition of termination resistors 
involves connecting a 1,000 ohm resistor from 
each data line to ground. To ensure even better 
signal clarity (and also to maintain the 'high' 
level the computer normally sees on its lines), 
also attach a 470 ohm resistor from each data 
line to +5 volts. In all, then, eight resistors will 
be needed for each project you add. 

Finally, do not skimp on the power supply. 
Generally you will see a 2,200-microfarad 
capacitor followed by a regulator, a 470- 
microfarad capacitor and a 100-nanofarad 
capacitor. This is the absolute minimum 
configuration for a working power supply. If you 
have the room, increase the value of the first 
capacitor to 4,700 or 10,000 microfarads, and 
place a 100-nanofarad capacitor between input 
and ground physically near the voltage 
regulator. 



0.1UF' 
50V 



0.1MF 
5DV 



1 ,0Q0uF 
35V 



1,000uF 
35V 



0.1uF' 
50V 



0.1 UF 
50V 



"*• +5V 



500PF 
16V 



500UF 
16V 



The Custom TRS-80 15 



Box / Power Supplies 



117 VAC 



14 VAC 1 A 



» 



19.8 VDC 35G mA 




TRS-80 transformer adaptor and supply. 
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Those Colors: What They Mean and 
How to Read Them 

The color codes used for resistors, 
capacitors, and other parts are brought to 
you by the same folks that brought you 
phrases like 10W-40 and RS-232C: the 
standards-setting powers of the engineer- 
ing industry. It becomes an international 
shorthand. 

The colors are black, brown, red, orange, 
yellow, green, blue, purple, grey and white. 
If you can't immediately remember that, 
then pick up a piece of multi-conductor 
'rainbow' cable. The colors are all there in 
the same order. The table below presents 
the color codes and how they can be read 
on the bodies of resistors, capacitors, and 
diodes. 
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computer work is done with 1/4 Watt 
resistors. 

For resistors without color bands, the 
values are stamped on using R (instead of 
omega) for ohms, K and M. 

Capacitance is the inclination of a non- 
conducting object to store an electrical 
charge, measured in Farads. The abbrevi- 
ation is a capital F. Since this is a very 
large amount of capacitance, real work is 
generally done in millionths of Farads, or 
microfarads (mF), and millionths of 
millionths of Farads, called picofarads 
(pF). Since many of the more popular 
capacitance ranges for computer work fall 
between these two figures, the abbrevia- 
Otion for thousandths of millionths of 
Farads, or nanofarads (nF) is common in 
Europe. The ability of a capacitor to 
withstand voltage is measured in voltage 
tolerance (V). 

Capacitance is usually printed on the 
capacitor in mF; color bands are rare. 
Picofarads are marked "p'; the absence of 
an abbreviation indicates microfarads. 
Note that these capacitor 'base values' 
are equivalent: 18=20, 27=30, 39=40, 
47=50. 



What do these values mean? Resistance 
is a kind of objection to electron flow, 
measured in ohms (pronounced with a 
long O). The abbreviation is a Greek 
omega ( fi ). Thousands of ohms are kilo- 
ohms, or just kilohms, and abbreviated K 
(k in Europe). Millions of ohms are 
megohms, abbreviated simple M. The 
ability of a resistor to withstand electrical 
current is measured in Watts (W). Most 
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Abbreviations and Conventions Used 
in this Book 



A0-A15 Computer address Lines. 
C A capacitor, specified in the parts 

List; positive and negative sides 
are marked* 
CLK CLock, usuaLLy a fLip-fLop input. 

CLR CLear, usuaLLy to fLip-fLop or Latch, 

CR A diode. Radio Shack schematic reference, 

D A diode, specified in the parts List. 

D0-D7 Computer data Lines. 

F Farad; used onLy as part of mF, uF, pF. 

GND Common computer ground. 

K A reLay, specified in the parts List. 

-K Resistance vaLue suffix = x 1000. 

LED A Light-emitting diode, specified in the 

parts List, 
m- Capacitance prefix for x 0.000 001. 

M A motor, specified in the parts List. 

-M Resistance vaLue suffix = x 1,000,000. 

MHz Megahertz [mi L Lion cycLes per second], 

p- Capacitance prefix = x 0.000 000 000 001 

P Piggybacked integrated circuit. 

PRE Preset, usuaLLy to fLip-fLop or Latch. 

Q. Transistor, specified in the parts List. 

Q FLip-fLop or Latch output. 

R A resistor, specified in the parts List. 

S A switch, specified in the parts List. 

T Transformer, specified in the parts List, 

u- Capacitance prefix for x 0.000 001. 

U Integrated circuit [LNW references onLy). 

Vcc CoLLector-suppLy voLtage, that is, the 

'five-voLt suppLy ' . 
W Watt; resistor power reference. 

X DIP shunt or jumper, R/Shack reference. 

X CrystaL osciLLator. 

Y DemuLtipLexer output signaL. 

Z An integrated circuit, specified in the 

parts List. 
* Used in text references for 'not 1 , in 

pLace of a horizontaL bar across the 

top of the abbreviation. 
0V Ground, zero-LeveL, or center-ground. 

+5V Five-voLt positive reguLeted power 

suppLy, the 'Five voLt suppLy 1 . 
-5V 5-voLt negetive reguLeted power suppLy. 

+12V 12-voLt positive reguLated power suppLy. 

117V House current, 105-120 voLts AC. 

BASIC commands; Z-80 mnemonics and 
opcodes; CPU and other schematic signals 
are printed in UPPER CASE letters. 
Hexadecimal numbering is printed in 
BOLD letters. 
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Getting Inside 

A TRS-80 is the proverbial black box. It's the 
first mass-marketed personal computer that was 
intended for simple home and business use. As 
far as retail sales are concerned - whether it's a 
car, a hi fi, or instant pudding - thinking of it as 
a black box is just fine. "Yes, it's a complete 
computer with a keyboard unit, video display, 
and cassette storage." 

To have this small computer work to even a 
fraction of its potential, though, you've got to 
have the power to control it. As with driving a 
fine automobile, that power comes with 
understanding, comes with being able to look 
through and into the box, comes with keeping it 
carefully tuned and customized so that it can 
respond to your wishes. 

In this Chapter we'll open the electronic black 
box a little at a time. If this is all new to you, 
prepare for some exciting finds inside this box; if 
not, then follow along and discover just how 
much you've learned about microprocessors in 
their own age. 

What You See 

The main computer unit is in a small case 
looking something like a typewriter that has lost 
its carriage. There are 53 keys in a typewriter 
style layout, and perhaps on your unit a numeric 
keypad to the right. Connections on the back are 
marked Power, Video, and Tape, along with an 
on/off switch. 

The unit is entirely silent. It is electronic in 
conception and execution. 

A power supply lowers and isolates the 
120-volt household supply to approximately 
one-seventh that value, and that feeds the 



keyboard unit. An ordinary cassette player is 
cabled in, and a partly disemboweled television 
set plugs in place, serving as a crude video 
monitor. 

The designers of the TRS-80 struggled with, 
and won, the battle of familiarity. Televisions, 
cassette recorders, and typewriters are among 
the most ordinary of home or office appliances. 
But by winning this battle of familiarity, the 
designers also clearly set themselves up to lose 
the battle of reliability (more on that later). 

Let's first take a look at some of the things the 
computer does, and then very generally try to 
discover how and with what the machine does 
them. 

When you power up your computer, you expect 
to be able to communicate with it. Unlike a 
television, it does not entertain, but rather 
evaluates and responds with an electronic 
psyche. If it were not capable of using a 
human-like language, we would be forced to use 
the machine's language. But since it will be asked 
to accomplish human tasks, we will demand that 
it speak a human sort of language - BASIC 
(Beginners' All-purpose Symbolic Instruction 
Code). BASIC has grown since its humble but 
inspired beginnings at Dartmouth College into a 
formidable tool capable of rocking other 
standard languages off their computational 
pedestals. If you have been using your TRS-80's 
BASIC, you know its fluidity. But it does not 
work alone. 

The BASIC that is in the TRS-80 works 
hand-in-hand with the electronics to produce a 
video display for us to read, and to examine a 
keyboard for us to type on. The keyboard gives 
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input to the computer, the video display shows 
output from the computer. Input and output are 
grouped together in computer terms, and are 
collectively called I/O. The tape recorder, which 
saves and loads computer programs, would also 
be called I/O. 



Forget the claims that the TRS-80 computer 
can do what this-or-that state-of-the-art 
computer could do five years ago. Maybe so, 
but it really can't. Because it isn't built like a 
piece of office furniture. Because it doesn't act, 
work, or 'think' the same. No matter how you 
paint it or pad it, a four cylinder sportscar will 
never be a luxury V-8 sedan. And Burger King 
is not a candidate for the four-star list. But 
they can do what they can do as well or better 
because of the simple, direct, streamlined 
nature of their operation and conception. Turn 
away the question of value judgment, and you 
discover that - considering portability, cost, 
ease of maintenance, accessibility and vastness 
of the software domain - the TRS-80 is 
probably a dimension better than that recently 
demised state-of-the-art dinosaur. 



That about covers what we can say about the 
minimal TRS-80 setup - a keyboard computer 
unit with I/O. Before popping off the cover, let's 
name some of the rest of the I/O devices that can 
be hooked up to the machine. Those might 
include: 

An Expansion Box. 

This attachment expands not only the 
internal capacity of the computer, but also 
forms an electronic saddle, permitting other 
devices to ride on the back of the keyboard 
unit. 

A Printer. 

Obviously, an attachment to provide a 

permanent record of the machinations of the 

TRS-80. 

A Diskette Drive. 

A place to store information and programs 
when the computer is turned off; it is very like 
the cassette player, except that it is speedier 
and can be accessed differently. More on that 
later. 

Voice Input/Output. 

An ability to speak and be spoken to on the 
part of the computer. This is one of the 
experimental options. 

Telephone Communications. 

Communications with other computers, 



similar or different, nearby or across the 
world. 

Control Centers. 

The power to change, activate or extinguish 
electrically-powered equipment throughout a 
home or office. 

There are more devices which might be 
considered, including clocks to tell the time of 
day, little circuits to create sound effects and 

music, even other computers used as 'slaves'. In 
fact, where electrically controlled equipment is 
involved, almost anything can be attached 
directly or indirectly to the TRS-80. 

Hesitation 

When you open the computer's case, you'll see 
an enormous amount of electronic circuitry. 
Before you open it though, you should have an 
idea why there are so many integrated circuits 
and circuit board traces connecting them. 

We live in an analog world. We judge size or 
volume or loudness not by how big or full or loud 
it is, but by how big or full or loud it seems in 
relation to something else, even if that 

'something else' is merely what we are used to 
hearing in our normal world. 

In other words, all our evaluations are made by 
analogy. "How big is it?" "As big as a 
basketball!" "Is she pretty?" "Pretty as a 
picture!" "Is it far?" "About a stone's throw 
from the corner." Our cliches are built on 
comparison or analogy. Ideally, then, we might 
like to build a machine that work for us in our 
own terms . . . 

"Machine!" 
"Duh, yessir, sir." 

"Add fourteen and thirty-seven, machine!" 

"Yup, yup. Lessee. Hmmm, fourteen is 
this big. And thirty-seven is this big. 

That makes a number this big 

Sir?" 

"Yes, machine?" 

"That's as much as thirty-seven and 
fourteen, sir! Looks just like fifty-one, 
sir." 

"Thank you, machine." 

This computer has a rather limited voice 
capacity, but what it did inside itself was 
electronically quite sophisticated. It took in a 
value and transformed it into an electrical 
voltage of fourteen units, stored it, accepted a 
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second value and transformed it into a voltage of 
thirty-seven units. Then it added the voltages 
together; the resulting voltage worked out to be 
equivalent to a value the size of fifty-one voltage 
units. 

The manufacturers of the real world might be 
able to create electronic parts with this kind of 
accuracy, but chances are that these parts 
wouldn't be cheap. A TRS-80 made with them 
would be worth more than the previously 
mentioned V-8 auto. 

So in the stone age of computer activity, it was 
decided that the simplest level of evaluations 
would have to be made. A low voltage or 'off 
condition would be made equivalent to zero; a 
high voltage or 'on' condition would be set equal 
to one. That was it. All calculations would have 
to be done with ones and zeros - the binary 
system. 

You've probably heard of, and perhaps used, 
binary numbers and there will be more on this 
system later in the book. But the point is that 
you can well imagine that doing work with real, 
human numbers means quite a basketful of the 
individual ones and zeros. Which means, 
consequently, many separate signal lines to carry 
those groups of numbers. 






So Open it Already! 

Turn the power off to your TRS-80 keyboard 
unit and flip over on its front. Carefully undo the 
cabinet, noting the different sizes of screws used 
to fasten it together. Holding the entire 
computer firmly together, again flip it on its 
back. Remove the top cover. Gently lift the 
keyboard forward and remove the five or six 
plastic spacers underneath it; in later 80's, one of 
these will be solid and the rest flexible. Note 
their positions. Now set the keyboard back, lift 
the electronics out of the case and place it on a 
spacious work surface. 

Time out. As you make changes to your 
TRS-80, add memory and the like, you will be 
opening the case many times. Two things might 
happen. First, the keyboard grommets will get 
lost. Their purpose is twofold: to prevent the 
keyboard from shorting against the main circuit 
card, and to cushion delicate parts against a 
constant onslaught of none too gentle typing. If 
you lose them, cut new ones out of bottle corks. 
They'll work just fine. 

Another more difficult problem is the 
keyboard cable itself. This is a band of springy 
copper leads covered with white plastic located 
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Photo 1-1. The TRS-80 opened and spread out 
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Photo 1-2. Closeup of. keyboard cable area. 
Complete TRS-80 spread out for cable replacement Other 
visible changes include Level I/II switch on keyboard (bottom 
right of keyboard), new Level II interconnect cable (center), 
additional keyboard socket (top left), and external reset switch 
connector (bottom left). 

at the bottom left of the keyboard. It electrically, 
and physically, attaches the keyboard to the 
main circuit board. Very subtle cracks can occur 
in the copper after about a half-dozen flexes. 
Symptoms can be lost letters or odd 
combinations of letters, a system constantly 
crashing or otherwise acting up, constantly 
repeating letters, or complete lockup of the 
keyboard. Avoid flexing this cable quickly or 
bending it sharply. Later we'll replace this cable 
with something better, but for the moment be 
gentle with it. 

Now back to the machine. Spread the two 
sections connected by the keyboard cable out in 
front of you. The keyboard and the top of the 
circuit card will now be visible. The Central 
Processing Unit is a single integrated circuit, the 
Z-80; it is to the far left in the photograph on this 
page. The power supply is the block of 'heavy 
equipment' at the back; the two small 
potentiometers regulate the voltage to within 
five percent, so keep clear of these controls. The 
eight memory circuits are in a row near the power 
section, and the language memory (Level I and 



newer Level II BASIC) is located in the center of 
the circuit card. On most Level II units, this 
language required three integrated circuits, and 
so these were placed on a separate 
two-by-three-inch card taped to the main board 
and connected with a 24-conductor cable. Don't 
be tempted to remove that cable, yet! 

A group of circuits to the bottom left in the 
photograph hold the video image. Two 
important parts are socketed on the board; these 
are marked Z3 and Z71, and they are 
programmable shorting jumpers. What makes 
them programmable is the fact that with a 
gouging tool you can break the connections; not 
very subtle, but it works. Their purposes are 
different - one selects the amount of memory 
available in the keyboard unit, and the other 
selects which of the standard languages (Level I 
or Level II BASIC) is in use. 

At the top left, the video and cassette output is 
controlled. Two small potentiometers on that 
side of the board position the video image on the 
screen, so if you received a TRS with its image off 
center, twiddling these will straighten it out. The 
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Figure 1-1. Z-80 block diagram from Zilog. 



16K RAM Expansion Service Manual and 
Addenda (Order). 

TTL Databook (National Semiconductor). 
Catalog No. 62-1370. This may not be 
stocked anymore; if so you can order it from 
National Semiconductor direct. 

And finally, a Z80-CPU / Z80A-CPU 
Technical Manual should be ordered from 
Zilog, Inc., 10340 Bubb Road, Cupertino, CA 
95014. It costs $7.50. 

These references will not only help you to 
make the modifications suggested in this book, 
but also to understand the operation of the 
computer, bend it to your wishes, and repair it if 
it fails. Additional references which you will find 
valuable are listed in Appendix II. 



remainder of the board is dedicated to 
controlling the complex electronic traffic. 

One last item is the edge card connector, which 
can be viewed at the top right hand side of the 
photograph. Through this connector, the 
TRS-80 may speak to the outside world. Much 
more on that connector later in this book. 

On the keyboard itself there are a few circuits. 
Their job is to assist the Central Processing Unit 
(CPU) in determining which key is pressed. 
These circuits are sometimes remarkably 
sensitive; there will be more about these later. 

Put it Back 

Become familiar with the layout of this board, 
as it will assist you in locating work or repair 
areas. Functions of the computer parts are 
generally grouped together, so modifications will 
usually be restricted to a compact area of the 
board. Once you have a good idea of where 
everything is, put the keyboard unit back 
together carefully. 

To really get to understand your machine you 
will want to obtain, either off the shelf at Radio 
Shack, from a Repair Center, or 'National Parts', 
the following manuals: 

TRS-80 Micro Computer Technical 
Reference Handbook. Catalog No. 26-2103. 

TRSDOS & Disk BASIC Reference Manual. 
Catalog No. 26-2104. 

Printer Cable Service/Installation Manual 
(Order). 

Expansion Interface Service Manual (Order). 
Make sure this includes the FD1771 disk 
controller appendix from Western Digital. 



The Hidden Insides 

It's not much of a mystery to TRS-80 users 
that all that hardware is controlled by software. 
That's one of the first things you learn. But it's 
also as simplistic as saying that the driver makes 
the car go, and just as misleading. Complete 
computers are called 'turnkey' systems because 
they imply simple, appliance-level setup and use. 
But a customized TRS-80 suggests something 
more, and with that 'something more' comes a 
requirement to have a better handle on hardware 
and software. 

Let's define some terms. The TRS-80 is a 
personal computer, which is a popular way of 
saying a small, microprocessor-controlled, 
turnkey computer. The microprocessor, a Z-80, 
is a complicated, general-purpose, electronic 
switching center capable of accepting, changing, 
sending, and re-routing a complex array of 
electronic signals. 

Both the TRS-80 as a whole, and the Z-80 in 
microcosm, have something called architecture. 
Architecture is the overall dimension by which 
these devices define their electronic space. Put 
simply, it is 'how they work'. As with all human 
work, this involves defining tasks and their order, 
executing those tasks, and producing a result. 

In the Z-80, the architecture involves 
accepting electronic signal groups called 
instructions, decoding them into internal 
activities, and executing those activities. An 
arithmetic logic unit (ALU) performs simple 
mathematical functions, internal memory cells 
called registers hold signal information to be 
acted upon, and an internal bus controls the flow 
of electronic traffic. The order of entering signals 
is identified by means of an address, which 
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identifies a fixed numbered slot in the Z-80's 
electronic universe. 

In the block diagram of this activity, shown 
opposite, note the terms '8-bit data bus' and 
'16-bit address bus'. The Z-80 is an integrated 
circuit with 40 external connections. The 
number 40 is arbitrary, chosen because 
manufacturing precision is currently limited to a 
physical 'package' of that size. That precision is 
also central to why the binary system is used, as 
mentioned earlier. 

From the viewpoint of ten-fingered humans, it 
would be simpler to do our computing in familiar 
decimal form. As with the uninspired 
conversation between human and computer 
presented earlier, different levels of voltage 
could be used. But such levels of precision are 
difficult to produce commercially and impossible 
to diagnose when they fail. 

That is the practical origin of the simple 
one/zero, on/off, true-false system of numbering 
used by the computer. To discover how these 
signals are arranged, we now turn back to the 
Z-80 itself and the 40 external pin connections. 
Information put into and called for out of the 
processor is called data, with a simple small 
value of zero. Any reasonable number of pins 
could have been dedicated to accepting data, but, 
based on the amount of work the processor had to 
do, eight of the 40 pins were assigned. This is the 
8-bit (binary digit) data bus. 
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Figure 1-2. TRS-80 memory map. 



Likewise, there is the need to determine the 
order in which the processor is to do its work. In 
order to move from command to command, it 
identifies the order of those commands by their 
position, or address. Sixteen of the Z-80's pins 
are used to specify a number from 0000 0000 0000 
0000 to 1111 1111 1111 1111. 

When the power is turned on, this address bus 
switches to all zeros. The computer fetches its 
first command along the data bus from that 
all-zero location. It executes the instruction, 
fetches the next, and the next, and the next. 

There's certainly more to this, but very 
basically that's the architecture of a 
microprocessor. Address lines for locations and 
order, and data lines for information. Now we'll 
turn to the TRS-80 and its architecture. 

The TRS-80 contains the microprocessor, 
which is the Central'Processing Unit (CPU) of 
the computer. Along its address bus is found the 
computer's internal information and instruction 
storage block - its memory. Also along this bus 
will be found video memory, a block which is 
reserved to display information to us on the 
screen; a keyboard, which is given its own set of 
addresses; the BASIC language; some unused 
areas; and single memory slots in which are 
housed windows to the cassette recorder, disk 
drives, printer and so forth. 

This hardware is already familiar, so let's look 
at the hidden insides, the software. The BASIC 
system is found in permanent, Read-Only 
Memory (ROM). It consists of several major 
sections: 

• A keyboard scanning routine to discover 
and interpret activities at the keyboard. 

• A video processing routine which 
presents and updates the monitor 
information. 

• Input/output controls for saving and 
loading program material and operating a 
printer. 

• An interpreter capable of transforming 
the 'English' words which make up the 
BASIC we know, and determining what 
computational actions should be taken. 

• Memory-management systems which 
apportion the computer's available memory 
into blocks which will not conflict. 

• Arithmetic- and text-processing 
subroutines which can perform calculations 
and operations on numbers and 
alphanumeric characters. 
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Overall, the Level II BASIC language requires 
more than 12,000 separate 8-bit groups, known as 
bytes, to perform its work. 

At the end of this Chapter is a detailed look at 
how the software operates from the time the 
machine is switched on to the time you read 
MEMORY SIZE? on the screen. In summary, 
that software disables any signals which might 
interrupt its operation, turns off the cassette 
relay and clears data from that output, restores 
the video screen to 64 characters per line, and 
sets up a block of memory for use by BASIC 
programs. A disk drive is searched for, and if one 
is found, a group of procedures are initiated in 
order that the disk program may take control of 
the TRS-80. 

If no disk drive is found, the screen is cleared 
with blanks, the MEMORY SIZE? prompt is 
displayed, and a keyboard scanning process is 
begun. A valid response to that question is 
accepted, and, if necessary the entire bank of 
memory is tested. Error messages are updated on 
the video screen as needed. Finally, the memory 
size and available room for text strings is created, 
the READY prompt is displayed, and control of 
the TRS-80 is given to the user. 

Power-Up Routines 

The initialization routine of the TRS-80 is a 
complicated and very interesting aspect of the 
computer. It must, of course, set up all the 
parameters that will be used by BASIC 
programs, but it also conducts a series of tests 
and makes hardware adjustments to the device. 

It double checks to assure the proper operation 
of memory, and to be certain that the parameters 
needed for proper operation of programs will be 
present. This section will take a look at the 
initialization process. 

Here are the first few instructions: 



0000 




ORG 


0000H 


0000 


F3 


DI 




0001 


AF 


X0R 


A 


0002 


C3 74 06 


JP 


0674H 



At power-up, the Z-80 chip 'homes in' on 
address 0000, and begins its execution there. The 
first action is significant: DI (Disable Interrupt) 
keeps the clock 'heartbeat', generated by the 
expansion interface, from disturbing any actions 
of the computer - especially important, since the 
necessary software for handling that interrupt 
request is not in ROM, but rather a part of the 
disk BASIC, or what is also offered as 'Level III' 
BASIC. 

So the interrupt is masked out. XOR A is the 
process of 'exclusive-ORing' the accumulator. 



Exclusive OR is a logical operation which states: 
of two elements, either may be zero or one, but 
not both. Thus, whatever is present in the 
accumulator is XORed with itself. Since each bit 
is identical with its exclusive-OR partner, each 
bit will be set to zero. This effectively clears the 
accumulator, readying it for processes to come. 

The final instruction of the group, JP 0674, gets 
out of the way of the Z-80's low memory, for it is 
in this area that the chip's restart codes - very 
frequently used subroutines - are found. Going 
on: 



0674 


D3 FF 




OUT 


10FFH) ,A 


0676 


21 02 


06 


LD 


HL.06D2H 


0679 


11 00 


40 


LD 


DE,4000H 


067C 


01 36 


00 


LD 


BC.0036H 


067F 


ED B0 




LDIR 




0681 


3D 




DEC 


A 


0682 


3D 




DEC 


A 


0683 


20 F1 




JR 


NZ.0676H 



After the jump to 0674, the routine resets the 
output flip-flop at port FF (255 decimal). This 
flip-flop controls both cassette functions and the 
32/64 character video, and by outputting the 
value in A (0, since it was exclusive-ORed 
earlier), the cassette will be off, no data will be 
present at its input, and video will come up 
normally. 

Following this is an interesting (and 
encouraging) piece of code. Using the Z-80's 
powerful block move command LDIR, 54 bytes 
stored at address 06D2 are transferred to the 
RAM address area starting at 4000. These are the 
most important pieces of information the 
TRS-80 must have, so the writers of this program 
took great care to assure that this transfer would 
be certain. The LDIR instruction itself takes 
data stored at an address specified by register 
pair HL (in this case, 06D2), and moves a block 
whose length is specified by register pair BC (36 
hex, or 54 decimal), to the location indicated by 
register pair DE (4000). 

The interesting part is found just below. The 
value in A (0) is decremented twice (to FE), and 
the identical transfer instruction is repeated. 
This goes on until it reaches zero again, a total of 
128 times! We may draw the conclusion that the 
Z-80 chip probably reaches full power and begins 
operating before memory gets to the point where 
it can reliably accept data . . . therefore, the 
instruction is repeated for a period of 
approximately 15 milliseconds. 

Now a portion of RAM is cleared to zero with 
the following few commands: 



0685 


06 27 


LD 


B.27H 


0687 


12 


LD 


CDEJ.A 


0688 


13 


INC 


DE 


0689 


10 FC 


DJNZ 


0687H 
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Recall that after the previous setup process, 
the accumulator again contains zero. Here a 
block of RAM specified by the DE register 
(essentially where we left off) is loaded with zero. 
Using the fast DJNZ (decrement B, branch if not 
zero) instruction, 39 bytes are fixed at zero. 

A few instructions follow that are very 
significant at power-up. Address 3840 contains 
the keyboard row where the BREAK key sits. It 
is connected to data line 4; thus the instruction 
AND 04 checks to see if it is held down. If it is not 
being held down, the result of the AND 
instruction will not be zero . . . and a jump to 
address 0075 will be made. This is why expansion 
interface owners without disks must press the 
break key at power-up: 



068B 


3A 


40 


38 


06BE 


E6 


04 




0890 


CE 


75 


00 



LD 


A.13840H 


AND 


04 


JP 


NZ,0075H 



How does the TRS-80 find out that a disk drive 
is in fact connected to the interface? The answer 
to that - and the reason that the computer 'hangs 
up' when an expansion interface is connected 
without a disk - is found in the next few bytes of 
code: 



0693 


31 


7D 


40 


LD 


SP.407DH 


0696 


3A 


EC 


37 


LD 


A,(37ECH) 


0699 


3C 






INC 


A 


089A 


FE 


02 




CP 


OS 


069C 


DA 


75 


00 


JP 


C.0075H 



The stack pointer is set at 407D for use by 
potential future programs; it is out of the way of 
all the BASIC pointers set up in the first data 
transfer, an obvious but important action. 

The accumulator is then loaded with the 
contents of memory location 37EC. There is no 
'memory' per se at address 37EC; it is instead an 
instance of 'memory mapping'. That is, when 
this memory cell is read, a signal is sent to the 
expansion interface. This signal strobes 
information from the Floppy Disk Controller 
(FDC) to the TRS-80. What will it find? 

If no expansion interface is connected, there is 
no signal to strobe. Hence, the value will be 
floating, not pulled to ground (zero) on any bit. 
The computer sees all bits apparently 'high' at 
this location, and interprets it as binary 1111 
1111, that is, hex FF. 

The next instruction increments the 
accumulator, in this case resulting in FF plus 1, or 
00. In the following intruction this value is 
compared to 2. A compare (in effect a 
subtraction, with no 'result') will cause the carry 
flag to be set, since minus 2 is negative. (Note: 



Why compare with 02? Why not just 01, as a carry 
would still be generated? My suspicion is that it 
is possible for those data lines to 'float' in the low 
state. In that case the CPU would 'see' 0000 0000, 
with the INC A instruction resulting in a value of 
01 - which is still incorrect. So a compare with 02 
guarantees the presence or absence of the disk 
controller.) 

Once the carry flag has been set, the 
instruction JP C,0075 would be executed, sending 
the program to address 0075. For the moment, 
however, let's assume that an expansion 
interface is connected to the TRS-80. 

The FDC, when queried by the command LD 
A,(37ECH), will respond with 80. Incremented by 
one it becomes 81, and comparing it with 02 
generates no carry. The JP C,0075H is thus 
ignored, and the program simply goes on to find: 



DB9F 


3E 


01 




06A1 


32 


E1 


37 


06A4 


21 


EC 


37 


06A7 


11 


EF 


37 


06AA 


36 


03 





LD 


A,1 


LD 


(37E1H) ,A 


LD 


HL.37ECH 


LD 


DE.37EFH 


LD 


(HL) ,3 



The accumulator is set to 1, and address 37E1 
is made to accept the contents of the 

accumulator. Again, 37E1 is a location memory 
mapped in the expansion interface. This code 
starts the disk drives rotating (or keeps them 
rotating), and selects drive zero. 

That done, it loads HL with the disk controller 
address (37EC) and sends out a 'restore' 
command, which tells the controller to move to 
track zero. Thus, the data will come from drive 
zero and track zero. Register DE is prepared by 
loading it with the disk's data address, 37EF. 
Now: 



06AE 


01 


00 


00 


LD 


BC.0000 


06AF 


CD 


60 


00 


CALL 


0060H 


0060 








ORG 


0060H 


0060 


08 






DEC 


BC 


DD61 


78 






LD 


A,B 


D062 


B1 






OR 


c 


0063 


20 


FB 




JR 


NZ,006QH 


0065 


C9 






RET 





This is a short but very useful subroutine. You 
may in fact want to call this yourself from time to 
time. Found at address 0060 is a simple delay 
loop; load the BC register pair (as is done just 
before the CALL instruction), and it is 
decremented and tested until it reaches zero. 
When it finally reaches zero, a return instruction 
sends the Z-80 back to the main program flow. 

Why a delay? Merely to give the disk drive 
time to come up to speed, obvious but very 
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important. Moving ahead with this branch of the 
program: 



D6B2 




ORG 


Q6B2H 


DEBS 


CB 46 


BIT 


D,IHU 


QBB4 


2D FC 


JR 


NZ.06B2H 



This is a loop which waits until the disk control 
chip says, "Okay, disk is up to speed and 
everything looks pretty good", and sends along a 
zero. The program loop tests this bit until it 
receives a zero. It is this loop which is maddening 
to you expansion interface owners who have no 
disk drive. Like all the previous 
memory-mapped addresses, 37EC will never 
have that zero. If a disk is present and all is well, 
the loop will have found the acknowledging zero 
sent by the FDC: 



06B6 


AF 






XOR 


A 


06B7 


32 


EE 


37 


LD 


(37EEH) ,A 


06BA 


01 


00 


42 


LD 


BC4200H 


OBBD 


3E 


BC 




LD 


A.BCH 


D6BF 


77 






LD 


(HL) ,A 


06C0 


CB 


4E 




BIT 


1 ,(HL] 


D6C2 


2B 


FC 




JR 


NZ.OBCOH 


0BC4 


1A 






LD 


A.CDE) 


06C5 


02 






LD 


(BC) ,A 


OBCB 


OC 






INC 


C 


06C7 


20 


F7 




JR 


NZ.06C0H 



The accumulator is cleared again, and the BC 
register is set to 4200. This will be an area of 
RAM set aside for disk use. 37EE is loaded with 
0, and 37EC is loaded with byte 8C. This selects 
sector 0, and sets the read condition. Thus, 
having previously been set to drive zero, track 
zero, it will now read sector zero. The 
accumulator will look for the incoming bytes in 
the memory location specified by the DE register 
pair (37EF). This is the memory-mapped 
location through which the actual data will flow. 

The accumulator picks up the data from DE, 
stores it in the RAM memory location indicated 
by BC (4200); the next instruction increments 
register C so that location 4201 is ready. The 
program loops back, waits for another message 
from the FDC, picks up another byte, and stores 
it. When register C finally reaches zero, the 
pointer will again contain 4200, and the loop 
terminates. Then: 



06C9 



C3 00 42 



JP 



4200H 



Here the disk system takes over completely. 
As you recall, starting at 4200, data from the disk 
has been stored. By jumping to that location, the 
program direction is wrested from ROM and 
given to the first 256 bytes of the disk system 
bootstrap program. 

Here, then, is a quick review of the activity so 
far: Interrupts are disabled, cassette is turned off 



and data are cleared from that output, video is 
restored to normal, and significant pointers for 
BASIC program operation are set up. A disk 
drive is searched for and if one is found, a group 
of procedures is initiated in order to transfer 
control of the TRS-80 to these disk instructions. 

A series of control signals and 
acknowledgments is exchanged between the 
floppy disk controller and the CPU, a page (256 
bytes) of data is poured into a RAM buffer area, 
and program control is given over to this new 
series of commands. 

If a disk drive is not found, or if the break key 
is held down during power-up, control is 
transferred to address 0075. At this point it 
should be noted that the 'reset' button on the 
TRS-80 is a non-maskable interrupt, that is, the 
only interrupt which the DI (Disable Interrupt) 
command first executed by the TRS-80 cannot 
mask out. When pressed, the reset button goes 
directly to address 0066, following a much shorter 
series of instructions reminiscent of the 
power-up routine. * 

Because it is likely most important RAM 
pointers are still intact, this sequence does not 
reset them: 



0066 








ORG 


0066H 


0066 


31 


00 


06 


LD 


SP,0600H 


0069 


3A 


EC 


37 


LD 


A, [37ECH] 


006C 


3C 






INC 


A 


006D 


FE 


02 




CP 


02 


006F 


D2 


00 


00 


JP 


NC.QOOO 


0072 


C2 


cc 


06 


JP 


06CCH 



This group of instructions sets up the stack 
pointer, checks for the presence of a disk drive, 
and jumps to the complete initialization routine 
(reboot) if it finds one. If none is present, it goes 
to the READY sequence beginning at address 
06CC. 

Now let us return to the initialization program 
flow we have been following, which is found at 
0075: 



0075 








ORG 


0075H 


0075 


11 


B0 


40 


LD 


DE,40B0H 


007B 


21 


F7 


1B 


LD 


HL.18F7H 


007B 


01 


27 


00 


LD 


BC,0027H 


007E 


ED 


B0 




LDIR 





Using the LDIR instruction described earlier, 
a block of information located at 18F7 is 
transferred to RAM beginning at 4080. These 
bytes describe ports in use, error storage, 
INKEY$ information, and so forth, as needed in 
the general operation of Level II BASIC (see 
Chapter 2). 
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A few specific addresses are delineated, and a 
large group of RAM bytes is then prepared. 
These jump to the familiar '?L3 ERROR' 
message because they are disk commands not 
available to Level II, yet patch points are 
prepared for them. The result of the following 
program statements is to fill addresses 4152 to 
41A5 with the direction JP 012D. "~ 



OOBE 


11 


20 


01 


0091 


06 


1C 




0093 


21 


52 


41 


0096 


36 


C3 




0098 


23 






0099 


73 






009A 


23 






009B 


72 






0Q9C 


23 






009D 


10 


F7 





LD 


DE.012DH 


LD 


B.1CH 


LD 


HL,4152H 


LD 


(HL3 ,0C3H 


INC 


HL 


LD 


(HL) ,E 


INC 


HL 


LD 


(HL) ,D 


INC 


HL 


DJNZ 


0096H 



Another group of ROM 'breakout' points 
follows; they all become returns to the main 
program flow. But notice something interesting 
about them - three bytes are set aside, but only 
one is filled with the return instruction (C9). 
This means that a jump command could be 
placed there. Let's first look at the series of 
instructions, then examine the possible benefits 
of changing them: 



009F 


06 


15 


OOA1 


36 


C9 


0DA3 


23 




00A4 


23 




00A5 


23 




0OA6 


10 


F9 



LD 


B.15H 


LD 


CHL) ,0C9H 


INC 


HL 


INC 


HL 


INC 


HL 


DJNZ 


D0A1H 



If we wanted to break into the BASIC 
operating system, this area of RAM is one place 
in which we could do it. Most of these are error 
codes of one kind or another. We could 'rescue' a 
program from displaying an error message, and 
halting, by patching in one of our own routines. 
If our routine were located at 5000, for example, 
the C9 instruction (followed by two unused 
bytes) could be replaced with a JP 5000 
command, which needs all three byte positions: 
C3 00 50. Essentially, the authors of Level II 
BASIC provided many areas for expansion. 

Now let's move on. BASIC programs begin at 
address 42E9. A pointer to that beginning is 
found as a zero at address 42E8. The next 
instruction sets that in place: 



a DAB 
D0AB 



21 EB 42 
70 



LD 
LD 



HL.42EBH 
(HL) ,B 



The stack pointer is delineated, and a call is 
made to 1B8F, a subroutine to turn off or reset 
various devices, including the printer and 
cassette player. It is in part redundant, but a 
double-check is often worthwhile. 



0AC 


31 


F8 


41 


LD 


SP.41F8 


00AF 


CD 


BF 


1B 


CALL 


1BBFH 


0OB2 


CD 


C9 


01 


CALL 


01C9H 



The call to 01C9 results in the screen being 
cleared and the cursor being placed at position 0. 
Finally, 'MEMORY SIZE?' appears: 



00B5 


21 


05 


01 


00BB 


CD 


A7 


2B 


00BB 


CD 


B3 


1B 



LD HL.D105H 

CALL 2BA7H 

CALL 1BB3H 



At address 0105 is a block of ASCII bytes which 
spell out MEMORY SIZE. The subroutine 
starting at 28A7 displays the string of data at the 
present location of the cursor, a byte at a time, 
until it finds a byte in the message whose value is 
00. This terminates the display and advances the 
cursor. The call to 1BB3 is identical to the 
BASIC INPUT command, in that it displays the 
question mark and cursor, and halts for keyboard 
input. 

If the keyboard input is the BREAK key, a 
carry is generated, and the program skips back to 
MEMORY SIZE and displays it again, waiting 
for keyboard input. The instruction RST 10 
(ReSTart at 0010) follows, which is the quickest 
way of calling a routine to locate the first 
character of an input. If one is found, the result 
of an OR instruction will not be zero. Here are 
the instructions that perform those functions: 



00BE 


38 


F5 


ooco 


D7 




00C1 


B7 




00C2 


20 


12 



JR 


C.O0B5H 


RST 


10H 


OR 


A 


JR 


NZ.00D6H 



What if, on the other hand, there was no entry 
other than the ENTER key? You have no doubt 
noticed a slight pause in the action when you do 
not specifically set the memory size. Here's a 
look at that code: 



00C4 
00C7 
00CB 
D0C9 
00CA 
00CC 
OOCD 
00CE 
00CF 
00D0 
00D1 
0002 
00D4 



21 4C 43 

23 

7C 

B5 

2B 1B 

7E 

47 

2F 

77 

BE 

70 

28 F3 

18 11 



LD 


HL.434CH 


INC 


HL 


LD 


A,H 


OR 


L 


JR 


Z,00E7H 


LD 


A,[HL) 


LD 


B,A 


CPL 




LD 


[HL) ,A 


CP 


CHL! 


LD 


(HL) ,B 


JR 


Z,00C7H 


JR 


D0E7H 



For the moment we will start at the instruction 
LD A,(HL). HL contains the address of a byte of 
RAM memory, the contents of which are placed 
in the accumulator. From the accumulator, they 
are also saved in the B register. The accumulator 
is complemented, which inverts all the ones to 
zeros and all the zeros to ones. This 
complemented value is then placed in the 
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memory location still specified by HL. The 
accumulator is compared with what has been 
placed in HL. 

What, you ask? But this value was just placed 
in memory, why compare it? Because - and this is 
a very elegant piece of writing - if it does not 
compare: 

1. The memory location is bad and only the 
block of memory below it should be used to 
be safe. 

2. Or, this is the end of memory. 

If this is good memory, then, the test for zero 
passes, the contents saved in register B are 
returned to memory, and the program loops 
back, incrementing HL to the next potential 
memory location. 

We did skip a few instructions back there. 
They become important only after the first loop 
is complete. These commands OR the contents 
of H and L; when the result is zero, we are at 
address 0000 - full 48k memory has been found, 
and the test is complete. 

Here's what we would find, alternatively, if we 
-entered some value (or other characters) in 
response to MEMORY SIZE?: 



0DD6 


CD 5A 


1E 


DDD9 


B7 




00DA 


C2 97 


19 


00DD 


EB 




OODE 


SB 




00DF 


3E BF 




00E1 


46 




DOES 


77 




0DE3 


BE 




00E4 


70 




D0E5 


SO CE 





CALL 


1E5AH 


OR 


A 


JP 


NZ,1997H 


EX 


DE,HL 


DEC 


HL 


LD 


A,8FH 


LD 


B.tHLJ 


LD 


(HL) ,A 


CP 


(HL) 


LD 


(HL) ,B 


JR 


NZ.00B5H 



The call to 1E5A checks for numeric input, and 
jumps to 1997 ('?SN ERROR'), if it is not 
numeric. If the input is properly numeric, then 
registers DE and HL are exchanged; this action 
puts DE (left off at the lowest usable memory 
location above pre-set RAM needed by BASIC) 
in HL, where it can be manipulated conveniently. 

Memory size minus one is usable; memory size 
and above is protected. So HL is decremented 
before being tested, then it is tested (in a manner 
similar, but not identical, to that done earlier). If 
the memory test fails, it's back to displaying 
MEMORY SIZE? again. 

We're not quite there yet, however, as the 
figure entered for memory size may be too small. 
BASIC needs a bit of room to work with, so DE is 
set to 4414, and the subtraction subroutine at 
RST 18 is called. If a carry is generated, we're 
shipped off to the '?OM ERROR' message found 
at 197A. Here's what it all looks like: 



00E7 


SB 




DEC 


HL 


00EB 


11 


14 44 


LD 


DE.4414H 


00EB 


DF 




RST 


1BH 


0OEC 


DA 


7A 19 


JP 


C.197AH 



A little more work is left to do. Recall that a 
value for available string space is set aside, and it 
is 50 bytes. Here is how it is done: 



00EF 


11 CE 


FF 


LD 


DE.OFFCEH 


OOFS 


33 B1 


40 


LD 


(40B1H) ,HL 


00F5 


19 




ADD 


HL.DE 


00FB 


SS AD 


40 


LD 


(40A0H) ,HL 



Register pair DE is set up with FFCE, which, if 
you are not yet weary of manipulation of hex 
numbers, is the two's complement of 50 decimal. 
That is, when FFCE is added to 0000, the result is 
FFCE hex, or 50 decimal less than the original 
figure. Try it to see that it works. This bit of code 
saves the value for top of available memory in 
40B1, adds register DE to it, and saves that result 
(memory size minus 50 bytes for string space) in 
address 40A0. 

There follows: 



00F9 



CD 4D 1B 



CALL 



1B4DH 



Here let me quote Roger Fuller, whose TRS-80 
Supermap identifies this subroutine this way: 
Revelation 21:5 -"And behold. . . He shall make 
all things new." 

This subroutine identifies and sets up all 
pointers necessary for the start of a BASIC 
program: Variables reset, previous program 
deleted, etc. 

And now, the moment you've all been waiting 
for. Here it is: 



0FC 


31 


11 


01 


OFF 


CD 


A7 


38 


ioa 


C3 


19 


1A 



LD 

CALL 

JP 



HL,0111H 

28A7H 

1A19H 



The call to 28A7, you may recall, displays a 
string of ASCII characters. The string displayed 
in this case is . . . 

RADIO SHACK LEVEL II BASIC 

The final instruction is a jump to 1A19, the 
address of the 'READY' display. 

To summarize this last portion of the 
initialization routine: all BASIC pointers, disk 
error codes, and ROM return codes are set up, 
the screen is cleared, and the MEMORY SIZE 
prompt is displayed. A valid response to that 
question is accepted, and, if necessary, the entire 
bank of memory is tested. Error messages are 
generated as needed. Finally, the memory size 
and available room for strings is recorded, the 
READY prompt is displayed, and control of the 
TRS-80 is given to the user. 
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Copacetic Comprehension 

There will doubtless be a day when books like 
this will be unnecessary. Personal computers will 
probably develop into the appliance area, with 
programmers, hobbyists, hardware designers 
and language specialists present only in the 
distant background of the market. But between 
now and then we are all faced with being either 
frustated users or solderer-programmers, 
tailoring machines according to our personal 
demands. 

To do this, certain skills are inevitably 
required. Among these are an understanding of 
non-decimal number systems, digital logic 
devices, machine-level languages, and a 
smattering of diagnostic sense. There are some 
fine books that cover all these topics (see 
Appendix II), so this chapter will only deal with 

them as far as needed to put this book to work. 

Among them are: 

• Binary, decimal and hexadecimal 
number systems, how they arose, how and 
why they can be used, and where 
understanding them is essential. 

• Common digital logic devices that 
appear in the TRS-80 and these projects, 
and how and where to use them. 

• Some of the basic elements of machine 
language, and a few personal considerations 
on where it is best applied, and when BASIC 
is a better choice. 



• A look inside the TRS-80, with an eye to 
diagnosing where troubles might lie and 
where changes might be in order. 

• The basics of creating a workable power 
supply for the projects in this book. 



Number Systems 

Numbering is the single most overrated 
problem in computer programming. The answer 
(posed before the question) is this: numbers are 
merely counting names. That is, it makes no 
difference whether we think in tenths of a mile or 
eighths of an inch. Nor does it bother us that a 
day is made up of 24 hours, while an hour is 60 
minutes. That a year is 365 days frightens us not, 
nor that months are a motley collection of sizes. 

In parking lots, does it bother us that our 
vehicle may be parked in Row N as opposed to 
Row 14? There is no mystery when we mark off 
points with four scratches and a Crosshatch. And 
does a dozen always conjure up' 'twelve', or is a 
dozen something we have understood since 
youth? 

Names are sizes are numbers; so it is with the 
number systems that we arbitrarily assign for the 
convenience of working with computers. When 
we are talking about electrical signals, it is 
clearest and easiest to think about ons and offs. 
Ons look pretty much like ones, and offs look like 
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zeros. It's a nice, clean concept, and one that 
illuminates the way we can refer to the 
machinery. 

There's more convenience to naming a 
computer data condition 10110100 than to 
calling it an on off on on off on off off. Were data 
the only consideration, the binary one and zero 
method might have been satisfactory, without 
resorting to other means or stroking our 
memories. 

Finding a location in a computer's memory is a 
much more difficult task. Although a memory 
location called . . . 

11101000100110101 

. . might be easier to think about than . . . 

onononoffonoffoffoffonoffoffononoffonoffon 



... it could use another step forward. In 
music, a long string of sixteenth notes like this - 




Figure 2-1. Illustration of illegible musical notation. 

- is broken up to make it legible, so it looks 
instead like this - 



..) & uEsi ^ mm 



Figure 2-2. Illustration of legible musical notation. 

Likewise, that long binary string can be broken 
up from 1101000100110101 into convenient 
groups . . . 



Converting Binary to Decimal 

In the grade school years, students used to 
learn that a number like 5,163 contained a 3 in 
the ones place, a 6 in the tens place, a 1 in the 
hundreds place, and a 5 in the thousands place. 
It was to remind them that 5,163 was really 3 
plus 60 (6 x 10) plus 100 (1 x 10 x 10) plus 5,000 
(5 x 10 x 10 x 10). 

The way other number systems are written 
follows this same pattern for their own bases. 
In base eight the number 5,163 would have a 3 
in the ones place, a 6 in the eights place, a 1 in 
the sixty-fours place, and a 5 in the 
five-hundred-twelves place. That means that 
5,163 is really 3 plus 48 (6 x 8) plus 64 (1 x 8 x 
8) plus 2,560 (5x8x8x8). But notice how 
that's decimal thinking! Really in base eight 
there could be no '8' . . . it would have to be 
called '10'! 1, 2, 3, 4, 5, 6, 7, 10, 11, 12, 13, 14, 
15, 16, 17, 20, and so on. So 5,163 in base eight 
is still 3 plus 60 plus 100 plus 5,000! 

The binary system sneaks in the same way. 
A number like 1101 0001 0001 0011 turns into a 
1 in the ones place, a 1 in the twos place, a in 
the fours place, a in the eights place, all the 
way up to a 1 in the 

thirty-two-thousand-seven-hundred-sixty-sevens 
place. In binary, the one on the far left is still a 
1 in the quadrillions place, don't forget. But 
the message is how to convert all this to 
decimal. And here it is: 

32768 16384 B1S2 4096 2048 1024 512 256 128 64 32 16 8 4 2 1 
1 1 1010010011 



Just add the numbers: lxl + 1x2 + 0x4 + 0x8 
+ 1x16 . . . + 1 times 32,768 = 41,619. Voila. 
No matter how long the number is, and in 
whatever base: 

1. Start at the left and produce a chart of 
the base number's powers, starting with 
(X to the power is always 1). 

2. Lay the number to be converted 
underneath the base number chart. 

3. Multiply each base number power by the 
digit in its place. 

4. Sum the resulting numbers. 

Does it work? Certainly. What is 163,341 in 
base 9? And in base 7? And in base 10? 



Base 9 powers: 


5 4 3 2 


1 





9 to that power: 


59049 6561 729 81 


9 


1 


NurabBr to convert: 


16 3 3 


4 




Multiplication: 


1x59049 6x6561 3x729 3x81 


4x9 


1x1 


Subtotals: 


59049 +39366 +21 87 +243 


+3B 


+1 


Converted result: 


100882, base 10 






Base 7 powers: 


5 4 3 2 


1 





7 to that power: 


16B07 2401 343 49 


7 


1 


Number to convert 


16 3 3 


4 


1 


Multiplicetion: 


1x16807 6x2401 3x343 3x49 


4x7 


1x1 


Subtotals: 


16807 +14406 +1029 +147 


+28 


+1 


Converted result: 


32418, base 10 






Base 10 powers: 


5 4 3 2 


1 





10 to that power: 


100000 10000 1000 100 


10 


1 


Number to convert 


: 1 6 3 3 


4 




Multiplicetion: 


1x100000 6x10000 3x1000 3x100 4x10 


1x1 


Subtotals: 


100000+60000 +3000 +300 


+40 


+1 


Converted result: 


163341 , base 10 
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1101000100110101 

. . . although the legibility is improved, the 
human spark, the ability to look and recognize 
(that aha! ) is not there. So the next step is to set 
about naming the sections. Since these on-off 
conditions can be written down as binary 
numbers, why not write them down in their 
decimal eauivalents? 

The question is rhetorical, of course, because 
not only can it be done, it is done. The only 
question is how to do it. Were a computer 
capable of swallowing all sixteen of those binary 
digits (bits) in one gulp, that question might be 
easily answered by calculating the conversion of 
1101 0001 0011 0101 using a binary-to-decimal 
conversion table. The result, we find, is 53557. 



But the computer, alas, cannot swallow all 
those bits in one bite ... it can only swallow one 
byte full of bits (pardon). In other words, though 
a computer may need numbers sixteen bits long, 
only eight data lines exist to carry that data. 

The component parts of the number 
1101000100110101 are needed, eight bits at a 
time: 11010001 00110101. 

There's the mathematical rub. 11010001 is 209 
decimal, and 00110101 is 54 decimal. This seems 
hardly related to 53,557. Another solution is 
necessary, and it is a naming system as much as a 

numbering system. It names each of the sixteen 
possible combinations of four binary digits: 



Reading the Pins 

Finding your way through digital circuits is 
much easier than finding your way through an 
ordinary table radio. Industry standards have 
made the process simple. Consumer integrated 
circuits are packaged in small, rectangular, 
plastic or ceramic cases with anywhere from 8 
to 40 external connections known as pins. 

Earlier integrated circuits - and many of the 
audio types currently being produced - were 
packaged in small metal cans and looked like 
transistors, with many wires protruding from 
the bottom. The wires were arranged around a 
keying tab on the edge of the can, and 
numbered like so: 




Figure 2-3. Can- type IC pin numbering. 

As such circuits developed into more 
sophisticated and powerful devices, more pins 
were needed for input and output. A 
rectangular package was developed, but it was 
still numbered in a circle, starting (when 
looking down from the top) from the left of the 
notch, so: m m m m 




All modern integrated circuits can be read 
from the top in this same way. 14- and 16-pin 
types start from the top left and read around: 

ra m fi m ra n m 



LJ hi Ld LJ LJ LJ LJ 
nq p m r fi R r 

) 



"i 



UJ hi U LJ - 1 
Figure 2-4. Dip- type IC pin number (8 pins). 



LJbJLilLJUJLJLiJLiJ 

Figure 2-5. 14- and 16-pin Dip IC pin numbering. 

You can read the pinouts of 18-, 20-, 24-, 28- 
and 40-pin circuits in the same manner. The 
highest numbered pin sits just opposite the 
lowest numbered pin. In the beginning this 
practice may seem confusing; it is. But after 
using the circuits - and counting their pins over 
and again - you will probably feel comfortable 
with the pin arrangement. 

Just one thing: when you assemble TRS-80 
add-ons, most of your work will be done from 
the bottom . . . which means reading 
backwards! 
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DODO 


is 


named 





and 


is 


equal 


to 


decimal 





0001 


is 


named 


1 


and 


is 


equal 


to 


decimal 


1 


0010 


is 


named 


2 


and 


is 


equal 


to 


decimal 


2 


0011 


is 


named 


3 


and 


is 


equaL 


to 


decimal 


3 


0100 


is 


named 


4 


and 


1s 


equal 


to 


decimal 


4 


0101 


is 


named 


5 


and 


is 


equal 


to 


decimaL 


5 


D110 


is 


named 


6 


and 


is 


equal 


to 


decimal 


6 


0111 


is 


named 


7 


and 


is 


equeL 


to 


decimal 


7 


1000 


is 


named 


e 


and 


is 


equal 


to 


decimal 


8 


1001 


is 


named 


9 


and 


is 


equal 


to 


decimal 


9 


1010 


is 


named 


A 


and 


is 


equal 


to 


decimal 


10 


1011 


is 


named 


B 


and 


is 


equal 


to 


decimal 


11 


11Q0 


is 


named 


C 


and 


is 


equal 


to 


decimel 


12 


1101 


is 


named 


D 


and 


is 


equal 


to 


decimal 


13 


1110 


is 


named 


E 


and 


is 


equal 


to 


decimal 


14 


1111 


is 


nemed 


F 


and 


is 


equal 


to 


decimaL 


15 



This may seem overdone; but A, B, C, D, E, and 
F are darn good names for binary values which 
exceed the number nine. If you don't have a 
name, make one up. For practical purposes, keep 
it within the symbols everyone has on the Royal 
typewriter. 

Back to the number 1101000100110101. Crack 
it into those four legible pieces (1101 0001 0011 
0101), and it can be named D135. To convert it to 
decimal, remember the old rule: the 5 is in the 
ones place, the 3 is this time in the sixteens place, 
the 1 is in the two-hunded-fifty-sixes place, and 
the D is in the four-thousand-ninety-sixes place. 
Thus, D135 is 5 plus 3 x 16 plus 1 x 256 plus (see 
the chart) 13 x 4,096, or . . . 53,557! 

So, that long binary number can actually be 
digested by the computer as a byte of Dl and a 
byte of 35. After a while, the number system 
comes easily. My personal recommendation: 
work in it. Convert to decimal only when you 
absolutely must. Think in hexadecimal and 
binary. They are the tools with which you can 
speak to the computer. 

Throughout this book, numbers in 
hexadecimal are printed in BOLD. 

Digital Logic Devices 



Back to digital logic devices. The essence of 
digital logic is to evaluate binary, on-off input; 
sometimes to determine a pattern of similarity or 
difference, sometimes to sense a change and 
sometimes to search for a signal. An appropriate 
result is produced as a result of the logical 
operation. 

One of the logic building blocks is called a gate. 
A gate electronically evaluates its input to 
determine the pattern of similarity and 
difference of signals, and produces a specific 

output. A simple gate is shown below: 




Figure 2-6. Simple AND gate. 

Its job is to determine if the first AND second 
inputs are both at the one (high) level. Only 
under that condition will its output produce a 
high (one) signal. The table below shows how 
this AND gate works. 



If input #1 is 


1 

1 



AND Gate 
If input #a is - The output result is 



Table 2-1. AND gate action. 



The table is called a truth table, and its 
purpose is to present every possible input and 
output condition for a given gate. Below is an OR 
gate. Stated in words, if either the first OR the 
second input is high, the output will be high. 
Examine the OR gate truth table; it really is quite 
logical. 



The binary number system and digital logic 
devices were developed together as a way of 

solving a practical dilemma: how to mass produce 
computers which could work quickly and 
accurately, and yet be inexpensive. As noted in 
Chapter 1, the problems of creating consistently 
accurate circuits, working with many different 
voltages levels, are formidable. Thus, simple 
yes-no, on-off logic was developed. 

The intimidating term Boolean algebra is 
being used for the first, and last, time in this book 
- right in this sentence. You'll probably hear the 
phrase from time to time, but no matter - it's a 
professional's buzzword to keep the masses out. 
Forget it. 




Figure 2-7. Simple OR gate. 



OR Gate 




Input 1 Input 2 


Output 




1 

1 

1 1 



1 
1 
1 



Table 2-2. OR gate action. 

Given a huge set of interconnected gates and 
their known inputs, the final output of the group 
can be determined by using truth tables like 
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these. Gates may have more inputs than two 
(some have sixteen), and may produce the 
opposite results from the two described above 
(NOT-AND and NOT-OR gates, known as 
NAND and NOR gates). Truth tables reveal how 
the integrated circuit's design engineer specified 
the pattern of binary logic inside the circuit. 

In this way, given a desired output and a 
known number of input signals, it is possible to 
determine what set of input values will trigger 
the desired output. 

There are a number of other types of digital 
circuits. Most are created out of gates like those 
described above, but their features are unique 
enough to think about them separately. Among 
these other digital logic circuits are buffers, 
flip-flops, counters, latches, multiplexers and 
shift registers. 

A buffer can be thought of as a two-input gate 
with both inputs tied together, like this: 



"fZ 




Figure 2-8. Buffer as (a) two-input gate and (b) buffer. 

Its truth table is much simpler than that for 
two-input gates, because there are now only two 
input conditions. Either both inputs are high, or 
both inputs are low. Gates with 'true' outputs 
(AND, OR) will merely follow the input 
condition. When the inputs are high, the output 
is high; if the inputs go low, the output becomes 
low. Separate logic devices are manufactured 
that perform this 'follow-the-leader' function, 
and they are called buffers. They serve to isolate 
sections of a circuit, or rejuvenate a signal so it 
can feed many dozens of inputs in a large 
machine. 

When a buffer reverses the condition of its 
input, (a high input is output low, and vice versa), 
the device is called an inverter. This kind of 
circuit can save the day in some cases, as when 
trying to locate a given binary number. Assume 
a circuit needs the binary number 1 110 to turn on 
a pilot light. It is possible to choose four separate 
gates, each of which would provide an output 



matching the desired number. These would be 
connected through more gates, and eventually 
the number could be discovered when the final 
signal was triggered properly. One way of 
detecting 1110 is shown below: 



Figure 2-9. Bad decoding scheme for 111 0. 

But, although this circuit works, economy of 
cost and space and simple clarity dictate another 
solution. The last input could be inverted before 
it is evaluated, resulting in a pattern (1111) 
which could be quickly recognized by a 
multiple-input gate. The result is electronic 
simplicity and legibility; an improved decoding 
circuit is shown below. The ultimate result is the 
same. 




Figure 2-10. Good decoding scheme for 1110. 

A flip-flop is a 'black box' which provides two 
outputs. When an input value is high (one), the 
first output will be high, and the second will be 
low. When the input value switches low (zero), 
the outputs will reverse. In other words, two 
opposite outputs for the price of one. But there is 
another significant use of the flip-flop. 

Flip-flops also have an important input called 
a clock trigger, which is triggered only when its 
input returns to a given level. Only then will the 
outputs of the flip-flop reverse. That is, a given 
flip-flop clock may receive a 'zero' pulse. Its 
outputs will reverse. Then the zero pulse changes 
to a 'one' pulse. Nothing happens, but the trap is 
set to spring. When the one pulse changes back 
to a zero, the outputs reverse again. For every 
two changes at the clock, there will be but one 
change at the output. It takes four clock changes 
to produce two output changes. 
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Why is this useful? Because it is electronic, 
binary division. The truth table here shows how 
it works. 

Binary Division with a Ftip-FLop 
Output of First Flip-FLop Connected to Clock of Second 
Flip-Flops Change State Each Time Input Returns Low 



Clock 


FUp-Flop 


Second Clock 


Second F lip-Flop 


Input 


Output 



Input 




Output 


D 










1 
















1 


1 







1 


1 


1 







Q 


D 







1 


1 










1 


D 


1 


1 




1 


1 


1 


1 




1 


[Input] 


(Input/2) 






SInput/4) 


Table 2-3. 


Binary division with a 


: flip-flop. 





Digital logic devices known as counters are 
combinations of gates and flip-flops that allow 
certain patterns to be counted: Binary, Binary 
Coded Decimal (BCD, where the highest number 
is decimal 10), Gray code and others. 

Latches are very much like flip-flops, except 
that the input is 'captured' at the output by a 
trigger signal called an enable, a select, or a 
gating pulse. The input may change 
continuously, but the output only reflects the 
input when the enable is activated. Latches are 
very useful when hundreds of thousands of 
signals are flying around on one set of lines, and 
the computer must select only certain groups of 
signals. The cassette output of data is a latch; 
only the 500-baud (bits per second) pulses of 
data reach the cassette output, even though 
many different signals reach its input. 

Multiplexers are sometimes misunderstood, 
but mostly because of their formidable name. A 
traffic light is a multiplexer - it allows several 
streams of traffic to meet at one intersection, but 
only one stream to proceed. The multiplexer is 
the electronic equivalent, having several inputs. 

Gating signals select which of the inputs may 
reach the output. In a computer, this allows 
several devices to share a circuit (like the video, 
which must be sent to the screen, but also sends 
and receives characters from the rest of the 
computer). 

Finally, shift registers treat bits of data like a 
bucket brigade sends up water: it goes in one end, 
and at each electronic 'go!', the bucket is sent 
along one position. The dots which make up the 
video display are produced by circuits which shift 
them out to the screen one bit at a time, in 
synchronization with the monitor's sweeping 
electron beam. 



Into Machine Language 

If we put faith in etymologists, then 'language' 
- which comes from the Latin meaning whole or 
part of a tongue - is an inappropriate word to put 
after 'machine'. Better to call it code, or blurms, 
or bingo chips even. Whatever it is, it becomes a 
tool for providing the user with all the power 
inside the TRS-80. 

With a knowledge of binary and hexadecimal 
numbers, this language seems more fluid, and 
with a similar understanding of its electronic 

effects, it becomes the true 'lingua franca' of the 
computer. 

In Chapter 1, I pointed out that BASIC is 
really just a disguised form of machine language. 
It is disguised because it presents itself in 
English-looking words, and has a large store of 
safety valves, error traps and messages - to 
prevent it from falling down an electronic rabbit 
hole. 

For the moment I'll turn away from the 
metaphors, and present a practical simulation of 
that statement. The simulation can be familiarly 
written as follows: 

CLS 

When you command CLS (clear screen), 
BASIC enters a machine language subroutine to 
clear the screen. It automatically returns to a 
BASIC command-level 'READY' condition. 
Now I happen to know that CLS is located at 
memory address 01C9 (457 decimal), and that 
(non-disk system) 'READY' is found at 06CC 
(1740 decimal). 

As an experiment, type . . . 
SYSTEM (ENTER) 
/1740 (ENTER) 

. . . and you will be presented with the familiar 
'READY', exactly as if you had pressed the Reset 
button. You've executed a machine-language 
GOTO, jumping directly to the 'READY' routine 
in ROM. As a second experiment, type . . . 
SYSTEM (ENTER) 

/1457 (ENTER) 

Momentarily, the screen clears, but quickly 
crashes to MEMORY SIZE? Why did that 
happen? Notice that I said CLS was a 
subroutine. In other words, the routine must be 
called via some sort of GOSUB. The crash back 
to 'MEMORY SIZE?' occurred because there are 
no error messages in machine language unless 
you create them! 

There are two ways to simulate the required 
GOSUB. The first is to POKE the starting 



36 



Chapter 2 



Into Machine Language 



address of the clear-screen subroutine into the 
USR(O) command. The USR(O) command is 
identical to the SYSTEM command, except that 
it is the equivalent of GOSUB, where SYSTEM 
is the equivalent of GOTO. 

So 01C9 (clear screen address) is the USR 
entry point; it must be split in two pieces (01 and 
C9), converted to decimal (1 and 201), and 
POKEd into USR addresses 16,527 and 16,526. 
So. . . 

POKE 16527U 

POKE 16526,201 

M=USR(0) 

There. A screen clear without crashing to 
'MEMORY SIZE?'. But there is another way. 
The machine language command for GOTO is 
called 'JUMP', and its hexadecimal code is C3. 
The machine language command for GOSUB is 
named 'CALL', and its code is CD. So here is the 
solution: CALL 01C9. JUMP 06CC. 

Various hardware has its peculiarities. In the 
Z-80 microprocessor, addresses are always 
specified in reverse order. So CALL 01C3 is 
written CD (CALL) C9 (least significant byte of 
address) 01 (most significant byte of address). 
And JUMP 06CC is written C3 CC 06. 

The whole process to clear the screen and jump 
to 'READY' is coded: 

CD C9 01 C3 CC 06 

Quite simple. CLS equals GOSUB 01C9, 
GOTO 06CC, which equals CALL 01C9, JUMP 
06CC, which equals CD C9 01 C3 CC 06. The 

nice part of this little process is that it can be put 
anywhere in memory you like. Let's put it 
arbitrarily at 5000 to 5005 (20480 to 20485 
decimal). 



POKE 20480,205 ; 
POKE 20482,1 



POKE 20481,201 : 



POKE 20483,195 : POKE 20484,204 : 
POKE 20485,6 

Convert the six hexadecimal bytes to decimal 
as shown earlier, and POKE them in place. Now 
you have the program completely under control. 
It is ensconced in memory, it calls the 
clear-screen routine, and jumps to 'READY'. Do 
you believe it? Just try it, entering the program 
at 5000. . . 

SYSTEM (ENTER) 

/20480 (ENTER) 

There. A complete machine language program 
that functions from BASIC command level. 



If you're new to this, take a break. The next 
step is to write an elementary screen-clearing 
routine, instead of calling one already in ROM. 

I want to introduce a dilemma early on in the 
process of learning machine language. There is 
always discussion in computer programming 
about 'reinventing the wheel', and there is much 
truth to the suggestion that one should not do 
programming when the work has already been 
done. In the case of the screen-clearing program, 
the subroutine to do the work has already been 
created, and it is right there in Level II ROM 
waiting to be used. 

Why, then, write another one? Why, in fact, 
even call the routine via machine language when 
the BASIC CLS command works so well? Indeed, 
with a BASIC as powerful as Level II, machine 
language should probably be reserved for doing 
things that cannot be done in BASIC at all. 
Among these things are upper /lower case drivers, 
programs to send characters to a serial printer, 
music-making and sound effects, 
telecommunications and so on. Furthermore, 
where machine language seems required, it often 
makes sense to call as many Level II ROM 
subroutines as possible. 

Slick as this may be, it has two disadvantages: 
much of programming and customizing the 
TRS-80 requires an intense element of learning 
and understanding. Re-inventing the wheel is 
what everyone who learns must do, from the 
child who is forced through the memorization of 
'times-tables', to the adult who has lost a job 
after 25 years and must learn new skills. 

I can only present this from a highly personal 
point of view, as one who could not have learned 
machine language with any fluidity had I 
depended upon the software black boxes of 
others. I suggest that if you want a program to 
perform a certain action, try to write it in 
machine language. Try to make it do the same 
sort of error-trapping and other housekeeping 
that Level IPs subroutines do. Take the Level II 
code apart and have a look. But don't deny 
yourself the opportunity to learn, rather than run 
a personal software assembly line. End of 
sermon. Back to clearing the screen. 

The Z-80 microprocessor has internal holding 
latches called registers. Some are capable of 
holding eight bits, others sixteen. Some eight-bit 
registers may be paired up with others to create a 
single sixteen-bit register. These might be 
thought of as your only Z-80 machine code 
variables. In this screen-clearing routine, several 
registers will be used. The registers to be used in 
this experiment are: B, paired with C; H, paired 
with L; and A. 
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The last of these is the accumulator, a 
sophisticated register capable of doing simple 
arithmetic. Indirectly, the 'condition code' 
register (called the 'flags') will also be needed, 
and will be described when it is used. 

First, the program in its entirety: 



21 00 30 


START— 


— LD 


HL.3C00H 


01 00 04 




LD 


BC.0400H 


36 SO 






(HL),20H 






23 




INC 


HL 


0D 




DEC 


BC 


, , 




LD 


A.B 






OR 


c 


C3 XX XX 




JP 


NZ.LOOP 



Listing 2-1. Simple CLS demonstration. 

In the first line, the H and L register pair is 
prepared with the values 3C and 00. As a pair, 
they are capable, then, of pointing to memory 
position 3C00. This is the memory location of the 
first position at the top left of the video display. 
The next line prepares the B and C registers with 
04 and 00. Although they are pointing to memory 
location 0400, they are going to be used as a 
counter in this program, 400 is 1024 decimal, the 
number of places on the screen. 

In the next line, the parentheses around HL 
mean 'the memory location defined by'. That is, 
the command is saying 'store the value 20 in the 
memory contents defined by the H and L register 
pair' - in this case, 3C00. So LD (HL),20 stores a 
blank space (20 is the ASCII value for such a 
space) at the first place on the screen. Whatever 



was on the screen before is turned into a space. 

Notice that this has the name 'LOOP' next to 
it. This 'label' is for the programmer's eyes, not 
for the program's use. In the next two lines, the 
HL pair is incremented. That is, 3C00 is 
incremented to 3C01. Correspondingly, the BC 
pair is decremented, from 0400 to 03FF. You 
may see the pattern emerging - BC is being used 
in a kind of machine language FOR-NEXT loop. 

In BASIC, a FOR-NEXT loop is sort of 
self-testing. The programmer doesn't have to 

put in anything that checks the value of the loop 
variable; BASIC does it automatically. But in 
machine language, a test has to be made. The 
next two lines of the program make that test. 
The accumulator is prepared not with an 
absolute numerical value, but rather with 
whatever the B register reads at the moment. 
After one pass through, it will be 03. 

Then the accumulator is asked to make a 
logical judgment. Recall that earlier in this 
Chapter, logical OR gates were discussed. If 
either of two inputs were high (one), the output 
would be high (one). In this case, there are eight 
inputs, one for each bit in the byte. So the 
accumulator has been loaded with 03, thus . . . 

00000011 

. . . and it is being asked for the logical OR 
with whatever register C is now set to. In the first 
loop, that is FF - 

11111111 



What's in the Memory Map 

The memory map of the TRS-80 has been 
designed for convenient, immediate use. It 
consists of seven major sections: 

1. The BASIC language in 
read-only-memory (ROM). 

2. An unassigned blank area for future 
expansion. 

3. Special locations for cassette and disk. 

4. A keyboard matrix, appearing in four 
locations. 

5. A video memory. 

6. A reserved block of RAM for BASIC use. 

7. User-programmable RAM for programs, 
data, and variables. 

The onboard jumper, X3, selects which of the 
various language possibilities is active in the 
TRS-80 (see section on electronic organization 



below). Level I BASIC uses only 4,096 bytes from 
address 0000 to 0FFF, but Level II uses from 0000 
to 2FFF. Because of hardware shortcuts, the 
cassette, disk and keyboard locations are 
incompletely decoded, appearing in 'phantom' 
areas beyond those strictly assigned to them. 
Using incompletely decoded locations in the 
cassette/disk area can result in unexpected 

results. But the phantom keyboards can be used 
interchangeably with the actual keyboard 
address. 

The possible memory configurations of the 
TRS-80 Model I, together with reserved RAM 
areas, are shown below. 



Figure 2-39. TRS-80 memory map in detail 
Address Function 



RAM Pointer 



0000 - 

0000 

0FFF 

2FFF 

3000 

3700 

37DE 



Beginning of all ROMs 

Power-Up Position 
End of Level I ROM 
End of Level II ROM 
Beginning of unassigned area 
End of unassigned area 
■ Disc Status Address 
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37DF 

37EQ 

37 E1 

37E4 

37 EB 

37EC 

3B00 - 

38FF 

3900 

3A00 

3B0" 

3C0L - 

3FFF 

4000 - 

4000 

4003 

4006 

4009 

400C 

400F 

4012 

4015 - 

401 S 

4016 

1018 

401B 

401D - 

401 D 

401 E 

40 20 

4022 

4023 

4025 - 

4025 

4026 

40 2B 

4029 

40 2A 

40 2B 

4020 ■ 

402D ■ 

4035 

4036 • 

403C 

4030 

403E 

4040 ■ 

4047 

404B • 

407F 

40B0 • 

40BD 

408 E 

4090 

4093 

4094 

4036 

4037 

4099 

409A 

409B 

409C 

40BD 

409E 

409F 



Disc Data Address 
Interrupt Flip-Flop 
Dieo Drive Select 
Cassette Select 
Line Printer Data 
Disc Controller Chip 

Beginning of Keyboard 

End of Keyboard 
Phantom Keyboard 
Phantom Keyboard 
Phantom Keyboard 

Beginning of Video 

End of Video 

Beginning Reserved RAM 

Restart #0 Patch CRST 8) 
Restart #1 Petch (RST 10) 
Restert #2 Petch IRST 18) 
Restart #3 Patch IRST 20) 
Restart #4 Patch (RST 2B) 
Restart #5 Patch (RST 30) 
Restart #6 Patch IRST 3B] 

Keyboard Control Block 

Keyboerd Device Type 101) 

Driver Entry Address [2 bytes) 

Three Reserved Bytes 

Two Bytes Reading "KI" 

Video Control Block 



Video Device Type [07) 

Driver Entry Address [2 bytes) 

Location of Cursor 12 bytes) 

Cursor Character 

Two Bytes Reading "DO" 

Line Printer Control Block 

Printer Device Type (06) 
Driver Entry Address (2 bytes) 
Total Lines Per Page 
Current Line Being Printed 
Reserved Byte 
Two Bytes Reading "PR" 

Level II Workspace 

Unessigned RAM 

End UnassignBd RAM 

■ Beginning Keystroke Storage 

End Keystroke Storege 

Video Size / Ceesette Latch 
Reserved for DOS Use (2 bytes) 

■ Storage Area for TIMES 

End of TIMES Storage Area 

• Reserved for DOS Use 



End of DOS Reserved Aree 

Storage Area for Division 

End of Division Storage Area 

USR Entry Point (2 bytes! 

RND Storage Area (3 bytes) 

INP Storage Area 

INPut Port Number 12 bytes) 

OUTput Storags Aree 

OUTput Port Number (2 bytes) 

INKEY$ Storage Area 

ERROR Code Storage 

Line Printer Position 

Output Device Indicator 

Video Line Length (32 or 64) 

Video TAB area 

Reserved 



40A0 "1 


40A2 


40A4 *2 


40A6 


40A7 «3 


40A9 


40AA 


40AD 


40AE 


40AF 


40 BO 


40B1 *4 


40B3 


40 B5 


40 D3 


40 D4 


4006 


40DB 


40 DA 


40 DC 


40DE 


40DF 


40 E1 


40 E2 


40 E4 


40 E6 


40E8 4 5 


40 EA 


40 EC 


40 EE 


40FD 


40F2 


40F5 


40F7 


40F9 *6 


40FB *7 


40FD *B 


40FF 


4101 


41 1B 


411C 


4130 




41 A4 




41 E7 






4288 


42E8 






, A „ V 




• rt-ts 






,«,-■. 




<*-r 




,A*n 




4FFF 


7FFF 


BFFF 


FFFF 



String Space Pointer !2 bytes! 

Current Line in Use (2 bytes) 

Start of BASIC Program (2 bytes! 

TAB Position Value 

Input Buffer Pointer 12 bytes) 

Input #-1 Indicator 

Seed Number for RND [3 bytes) 

Rsserved 

LET Bnd DIM Scratchpad 

Number Type Flag 

"Fleg Byte for Encoder" 

Top of BASIC Memory (2 bytes) 

String Scratchpad Pointer , 

String Workspace £30 bytes) 

Length of String in Use 

Address of String in Use {2 bytes) 

Next AvaiLable String Space (2 bytes) 

State of Print Using (2 bytes) 

Current DATA Line In Use [2 bytes) 

DIM Scratchpad (2 bytes) 

Print Using Scretchped 

SYSTEM Loeding Entry Point (2 bytes) 

AUTO On/Off Indicetor 

Current Line in Use C2 bytes) 

Size of AUTO Increment 12 bytes) 

Location of BASIC Command in Use [2 bytes) 

BASIC Stack Pointer (2 bytes) 

ERROR Line Number for RESUME (2 bytes) 

EDIT Line Number in Use (2 bytes) 

Line Number before RESUME [2 bytes) 

ON ERROR GOTO Line Number (2 bytes) 

Reserved [3 bytesj 

Line Number Completed [see also 40E2) 

CONTINUE Line Number [2 bytes) 

Simple Variables Pointer 

Arrays Pointer 

Free Memory Space CFRECA)] 

Pointer to DATA in Memory 

Variable Type Workspace (27 bytes) 

TRON/TROFF Indicator 

Arithmetic Workspace (20 bytes) 

Line/Print Using Buffer (33 bytes) 

Disc PBtoh Points (see Chepter <?> 

End Disc Patch Paints 

DOS Linking Petch Points 

End Linking Patch Points 

KayboBrd/Edit Input Buffer 

Z-BO Stack During Running Program 
End Input Buffer 

Beginning of BASIC Program 

End of BASIC Program 

Simple Verieble Storage 

End of Variable Storage 

Array Storage Area 

End of Array Storage 

Free Memory Area 

End of Free Memory Aree 

BASIC Stock for NEXT, GOSUB. etc. 

Top of BASIC Stack (works downward) 

String Storage Aree 

Top of String Storage [works downward) 

Top of BASIC Memory 

End of 4K RAM 
End of 16K RAM 
End of 32K RAM 
End of 48K RAM 



- each bit in the accumulator is ORed with its 
corresponding bit in register C. If any pair of bits 
is 1, the accumulator's bit will be set to 1. When 
the ORing process is finished, the accumulator 
will contain the results, and the condition code 
register will reflect the meaning of those results. 



Listing 2-2. Complete CLS demonstration. 





001 QO 




00110 




001 £0 




0Q130 


5000 


00140 


5000 21003C 


00150 


5003 01FF03 


00160 


5DDB 3620 


00170 


5D0B 23 


001 BO 


5009 OB 


00190 


500A 7B 


00200 


500B B1 


0021 


5Q0C 20F8 


00220 


500E CS 


00230 


OBCC 


00240 


00000 TOTAL 


ERRORS 



SIMPLE CLEAR-SCREEN DEMONSTRATION IN ASSEMBLER FORMAT 

Mmmmmtmttmmtmmmmmmtm#tmtt 



LOOP 



ORG 

LD 

LD 

LD 

INC 

DEC 

LD 

OR 

JR 

RET 

END 



5000H 

HL,3C00H 

BC.3FFH 

(HU,20H 

HL 

BC 

A,B 

C 

NZ.LOOP 

06CCH 



BEGIN ROUTINE AT 20400 
VIDEO SCREEN, AT 153B0 
1 ,024 SPACES ON SCHEEN 
SPACE (DEC 32) IN PUCE 
READY NEXT SCREEN LOC'N 
DROP SPACES LEFT BY ONE 
GET CURRENT COUNT IN B 
OR WITH COUNT LEFT IN C 
GO BACK IF NOT YET DONE 
BACK TO MAIN ROUTINE 
READY AFTER TAPE LOAD 



On the first pass, the accumulator will end up 
containing 11111111, and the condition code 
register's 'zero' flag will read 'not zero'. The last 
line of the program says 'jump if the result is not 
zero'. It jumps back to the part of the program 
marked LOOP, where it will store a 20 (space) in 
the new value pointed to by HL, increment HL 
again, decrement BC again, and go through the 
logical OR test once more. 

If you carry the process through by hand, you 
will discover that only when B and C are both 
zero will the zero flag confirm a zero result. At 
that point, the program can shake loose from its 
loop. 
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Details of storage areas and their use can be 
found in Microsoft BASIC Decoded, Supermap, 
Inside Level II, and the Level II BASIC 
Reference Manual. 

Setting MEMORY SIZE? 

Because machine language programmers have 
devised many unique ways of storing their 
programs, the purpose of responding to 
'MEMORY SIZE?' has been the cause of some 
confusion. A look at the summary of the full 
memory map may help clarify the reasoning. 

Reserved Memory (not avel table) 

BASIC Program Text [fills upward) 

Simple Variables (fill upward) 

Array Variables IfiU upward) 

*<•***» FREE MEMORY SPACE "**»»»»» 

BASIC Stack {fit Lb downward) 

String Storage (fills downward) 

MEMORY SIZE Value (above reserved) 

Table 2-4, Memory map summary. 

This table points out two important facts: 
array variables grow upward into the free 
memory space. The BASIC stack (which stores 
GOSUB return addresses, levels of parentheses, 
FOR-NEXT information, etc.) grows downward 
into the free memory space. 

Simple variables can also bump the array 
variables upward; string storage space is set 
ahead of time with the CLEAR statement. So 
you can see that the free memory area is 
impinged upon from both sides while a program 
is running. Although BASIC might have been 
designed to bump everything upward in memory 
(leaving the top area of memory unmolested), it 
would have resulted in considerably longer 
running time. This is because many changes in 
memory would have to be made when new 
variables, strings, parentheses, GOSUBs, etc., 
were discovered during a program's run. 

If any machine language program is to be used, 
it certainly must be stored out of the way of this 
frantic activity. MEMORY SIZE therefore is 
used as a sacred boundary, above it is 'terra 
incognita' as far as the BASIC program is 
concerned. For example, if MEMORY SIZE in a 
16K machine is set to 20480, the computer acts 
precisely as if it were a 4K machine! 

To make maximum memory available for a 
running BASIC program, this boundary should 
be set only just low enough so that the machine 
language program will fit above it. Most program 
authors will write these programs to fit as high as 
possible in memory, and so you will normally see 
memory sizes (for a 16K machine) above 30000. 

Why in a 16K machine would there be a 
'memory size' of about 30000 and not 16000 or 
so? It's simply that the prompt 'MEMORY 



SIZE?' is a bad question. The memory size value 
is really not a size at all, but the address of a 
memory location above which the BASIC 
program and its variables must not go. 

Why then are there machine language 
programs which do not require memory size to be 
set? That is because clever programmers write 
machine language programs that . . . 

- may be written for Level II BASIC, and 
thus can reside in one of the DOS reserved 
areas (see memory map). 

- may automatically reset the memory size 
value before returning to BASIC. 

- may be packed into strings where they are 
safely protected in a program text line (see 
Chapter 3). 

- may be short enough to reside in part of 
the input buffer and change its pointer. 

In all of these cases, something is sacrificed for 
the convenience of not setting 'MEMORY 
SIZE?'. In the first case, DOS-like expansion 
programs, such as Level III BASIC, will conflict. 
In the second case, programs which also require 
the memory size to be set may be damaged when 
the loading program automatically resets it. 
Thirdly, string-packed lines may not be edited 
without calamitous results. And finally, a 
reduced input buffer makes editing long lines 
impossible, as they will probably run into the 
BASIC program text. 

So the 'MEMORY SIZE?' boundary is a useful 
feature of BASIC, serving to protect machine 
language programs from the expansionist 
tendencies of a running BASIC program. 

Comparing The Levels 

Another source of confusion to a lot of users 
was the switch from Level I to Level II. How did 
this simple change of language alter the 
hardware? How did double-width characters, 

500-baud tape loading, and key rollover suddenly 
appear? Why did the convenient abbreviations 
(P., N., M., F., etc.) suddenly go? Why were 
machine language programs happy with CLOAD 
in Level I, but needed SYSTEM with Level II? 

The 4K BASIC in Level I is a compact, limited 
language with a few capabilities. Level II is three 
times as long, and much more powerful. Their 
authors, and hence their approaches, are 
different. The single hardware change in going 
from Level I to Level II is the installation of one 
ROM set in favor of another, and a minor change 
to allow 12K instead of 4K ROM to be accessed. 
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The 32-character mode hardware was already 
in place. The tape load speed and key rollover are 
all software controlled (see supplement to this 
Chapter). The abbreviations disappeared 
because Level II handled its keywords in a 
different manner from Level I, and such 
abbreviations would have increased execution 
time. Likewise, tape loading formats were a 
matter of design philosophy rather than any 
formal software requirements. 

Level I has the advantage of being a simple, 
easily learned first language for computer 
beginners, and many TRS-80 owners learned by 
using that language. Level III is not a language 
distinct and apart from Level II, but rather an 
extension of the existing one. (In this sense it is 
much like Extended Color BASIC on the new 
TRS Color Computer, which does not supplant 
the original 8K BASIC, but merely adds another 
8K to it). 

What are the differences between the three 
levels? A command list for the three languages, 
with differences highlighted, follows: 

Table 2-5. Comparison of Level I, II and III commands. 
Command LeveL I Level II Level III 



6 




A. UBS] 


X 


ABS 


X 


ASC 




AT 


X 


ATN 




C. (CONT) 


X 


CDBL 




CHRS 




CI NT 




CL. (CLOAD) 


X 


CLEAR 




CLOAD 


X 


CLOSE 




CLS 


X 


CMD 




CONT 


X 


COS 




CS. (CSAVE) 


X 


CSAVE 


X 


CSNG 




CVD 




CVI 




CVS 




D. tDATA] 


X 


DATA 


X 


DEFDBL 




DEFFN 




DEFINT 




DEFSNS 




DEFUSR 




DEFSTR 




DELETE 




DIM 




E. [END) 


X 


EDIT 




ELSE 




END 


X 


ERL 




ERR 




ERROR 




EXP 




F. (FDR) 


X 


FIELD 




FIX 




FOR 


X 


FRE 




G. (GOTO! 


X 


GET 





X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 




X 


X 


X 




X 


X 


X 


X 


X 


X 


X 


X 


X 




X 




X 




X 


X 


X 


X 


X 




X 


X 


X 


X 


X 




X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 




X 


X 


X 


X 


X 


X 


X 



GC1S. (GOSUB) 


X 


GOSUB 


X 


GOTO 


X 


I. (INT) 


X 


IF 


X 


INKEYS 




IN. (INPUT) 


X 


INP 




INPUT 


X 


INSTR 




INT 


X 


KILL 




L. (LIST) 


X 


LEFTS 




LET 


X 


LSET 




LEN 




LINE 




LIST 


X 


LOAD 




LOC 




LOF 




LOG 




LPRINT 




M. (MEM) 


X 


MEM 


X 


MERGE 




MID$ 




MKDS 




MKIS 




MKSS 




N. (NEXT, NEW) 


X 


NAME 




NEW 


X 


NEXT 


X 


NOT 




ON 


X 


OPEN 




OUT 




P. (PRINT, POINT) 


X 


P.A. (PRINT AT) 


X 


PEEK 




POINT 


X 


POKE 




POS 




PRINT 


X 


PUT 




R. (RESET, 




RND.RUN) 


X 


RANDOM 




REA. (READ) 


X 


READ 


X 


REM 




RESET 


X 


REST. (RESTORE] 


1 X 


RESTORE 


X 


RESUME 




RET. (RETURN) 


X 


RETURN 


X 


RIGHTS 




RND 


X 


RUN 


X 


S. (SET, STEP) 


X 


SAVE 




SET 


X 


SGN 




SIN 




son 




ST. (STOP) 


X 


STEP 


X 


STOP 


X 


STRINGS 




STRS 




T. (THEN, TAB] 


X 


TAB 


X 


TAN 




THEN 


X 


TIMES 




TROFF 




TRON 




USING 




VAL 




VARPTR 




> 


X 


< 


X 



X 
X 

X 
X 

X 
X 
X 
X 
X 

X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 

X 
X 
X 
X 
X 
X 

X 
X 
X 
X 
X 
X 
X 



* indicetee that Level I and Level II operations 
differ for this command. 
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Hardware Reflects Software 

You are probably familiar with the general 
operating characteristics of your TRS-80, 
including BASIC commands and how the 
machine responds to them. These responses are 
characteristics of how the software treats the 
hardware, and also of how aspects of the 
hardware act independently of the software. 

The hardware inside the TRS computer can be 
broken into seven major sections: 



1. CPU Hardware 

A. Central Processing Unit (Z-80), its clock, 
power-up, and reset circuitry. 

B. Decoding of CPU status signals into 
memory /peripheral access signals such as 
read, write, input, output. 

C. Buffering of address and data signals to 
and from the CPU. 

2. Program RAM Control 

A. Refresh signals to maintain memory in 
dynamic RAMs. 

B. Address decoding able to distinguish 4K 
and 16K RAMs. 

C. Address multiplexing for dynamic RAM 
address lines. 

D. Read/Write signals to RAMs. 

3. Video RAM Control 

A. Address decoding for video RAM. 

B. Read/Write signals to video RAM. 

C. Input to character generator, timing, 
blanking signals so characters do not run off 
the screen. 

D. Access management between display and 
CPU. 

E. Alphanumeric/graphic switching and 
graphics character circuitry. 

4. Keyboard 

A. Address decoding for keyboard. 

B. Address/data buffering and read signals. 

5. ROM Control 

A. Address decoding for 4K and 12K ROMs 
(Level I or Level II). 

B. Outboard decoding for three 4K Level II 
ROMs or two Level II ROMs. 

C. Read signals. 



6. Output Controls 

A. Parallel-to-serial conversion from 
character generator. 

B. Horizontal and vertical video sync 
circuits, video output circuit. 

C. Cassette motor, cassette data, and 32 
character video output control. 

D. Cassette audio output circuitry. 

7. Power Supply 

A. Three regulated voltage outputs. 

B. Short-circuit protection. 

Each of these sections plays a major role in the 
operation of the TRS-80, and few could be 
trimmed or eliminated without completely 
changing the character of the computer. The rest 
of this Chapter will be devoted to detailing those 
aspects of the TRS which are significant to 
customizing the hardware or software of the 
machine. For a more comprehensive 
examination, including timing diagrams and 
discussion of each signal line, turn to the 
Technical Reference Handbook. 

CPU Hardware 

The master clock is produced by the 
oscillations of a 10.6445 MHz (million cycles per 
second, or Megahertz) crystal. A countdown 
circuit (Z56) divides this by 6, producing the 
running frequency of the Z-80, 1,774,083 clock 
cycles per second. This is generally called the 
TRS-80's 1.77-MHz clock. 




Figure 2-40. Clock circuit area of TRS-80, 



It's interesting to note that there are several 
other clocks on the computer's board, some 
already wired in place, and others which can be 
created by interconnections. At pins 11 and 9 of 
Z56, 3.548 MHz is available, twice the normal 
TRS-80 speed. Pin 2 of Z43 clocks at 5.322 MHz, 
faster than the Z-80 can run, but when connected 
to pin 14 of Z56, a 2.661-MHz clock is available. 
This is 1.5 times the normal clock speed. Both 
the 2.661 MHz and 3.548 MHz clock rates will be 
used in Chapter 4. 
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RESET 



74LS02 

]l 

SYSRES«[ 

Figure 2-41. Power-up reset circuit area of TRS-80. 



Upon power-up, the processor's RESET input, 
which sets the program counter running at 0000, 
is triggered by Z53 in combination with Z52. The 
capacitor C42 takes time to charge completely, so 
the RESET line is held down for a few 
milliseconds after the rest of the system comes up 
and is stable. This power-on reset is a 
convenience so the user doesn't have to press a 
special reset button just to get the system going. 
Other computers, such as the Ohio Scientific 
series, demand that inconvenient action. 

The TRS-80 design creates Read (RD), Write 
(WR), Input (IN) and Output (OUT) signals 
from the Z-80's Memory Use Request (MREQ), 
Input/Output Use Request (IORQ), Write (WR), 
and Read (RD) signals.These are combined by 
Z23, in the correct order to do that. The four Z-80 
signals are not wired to the edge card connector, 
so certain functions (such as mode and mode 2 
interrupts - see supplement to Chapter 5) cannot 
be used. 




Figure 2-42. Read/write status, multiplexer of TRS-80. 
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A TEST line is provided to 'float the bus' - in 
other words, the Z-80 becomes invisible, allowing 
another device to take over operation of the 
computer. Some outboard devices which speed 
up the TRS-80 use this feature, essentially taking 
control of the memory and peripheral devices by 
bringing the TEST line to ground. Z52 goes high 
in response, electronically disconnecting the 
Z-80's address and data bus from the circuitry. 
(Note that using the TEST line without 
memory-refresh backup circuitry on the outside 
of the computer will result in loss of memory 
contents). 



+5V 



JR58 
J4.7K 



1H>- 

TEST? 



5V 

t 



«- ENABLES 



25 



BUSRQ 



Figure 2-43. Test line circuit of TRS-80. 

In normal operation, the Z-80 lines are active 
and buffered by Z38, Z39, Z22 and part of Z55 
(address), Z75, Z76 and the remainder of Z55 
(data). Except when the TEST line is used, the 
address buffers are always active. The data 
buffers are active under any circumstances, 
either in their READ or WRITE configuration: 



Except for the memory refresh information, 
this completes the role of the Z-80 CPU circuitry 
in the TRS-80. 



Program RAM Control 

The CPU is also used in the creation of the 
signals needed to refresh the dynamic memories. 
Since the TRS-80 uses dynamic RAMs, (see 
Chapter 5 for details on this), the normal refresh 
(RFSH) output of the Z-80 is less than useful, at 
least in the minds of the computer's design 
engineers. That RFSH signal, which is output 
when the computer is not using the memory, is 
ignored in the TRS-80. 

Instead, the processor's MREQ line, when 
buffered, serves as a memory address row signal. 
The master clock is used in conjunction with the 
Z-80's RD and WR lines to produce a memory 
address column signal (column-address strobe, 
CAS) and a multiplex signal (MUX) to switch 
from row to column. This serves a very useful 
double purpose: not only does it refresh memory 
when the processor is not specifically using the 
memory in the program, but it serves as the 
address-select lines when the Z-80 processor is 
using memory. Refer to the Z-80 Technical 
Manual for details on the timing of these signals. , 




Figure 2-44. Address/data buffers of TRS-80. 
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Needless to say, should any of these signals fail 
or operate inconsistently, the memory will not 
retain its contents for very long nor will a 
program even run which uses dynamic memory, 
because its address may not be selected. 

The next subject is memory management. 
This is basically the means by which the 
processor gets to the memory it wants to use. The 
heart of this sequence is found in Z35 and Z51, a 
pair of multiplexers which send the low bits of 
the memory address to the dynamic memories; 
flip from low bits to high bits according to the 
incoming multiplex (MUX) signal; and send the 
high bits to the memory. The memory, upon 
receiving these addresses together with the 
previously mentioned RAS and CAS signals, 
knows which address is being selected, and 
responds accordingly. 

The DIP (Dual Inline Package) shunt Z71 
plays an important role here. Specifically, it 



Figure 2-45. Memory select/refresh of TRS-SO. 



231-2 
231-5 



■SHT2 




routes the signals to the multiplexers in such a 
manner that the computer can distinguish 
between 4K and 16K RAMs. Stated simply, 
what is a memory-chip select line for 4K RAMs is 
a complete address line for 16K RAMs, and a 
partial address line for 8K RAMs (which the 
TRS-80 was designed to use also). Thus, the 
higher address lines must be prevented from 
appearing at the CE (chip enable) input of the 4K 
RAMs. If this were to happen, phantom memory 
would appear, and a running BASIC program 
(and the power-up memory test) might try to use 
those phantom bytes: 
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■SHT2 
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Figure 2-46. Memory multiplex, CAS, RAS & memory. 



Figure 2-47. X71 and decoding scheme of TRS-80. 

Only a WR signal is used to trigger these 
RAMs, as a high signal on their WR lines 
prepares them to read data. The CE (Chip 
Enable) determines if data should be placed on 
the data bus, where it is buffered by Z67 and Z68. 



Video RAM 

Video memory is used in three ways: it is 
written to by the processor, read from by the 
processor and read from by the video display 
circuitry. In fact, it is constantly being read by 
the video display circuitry except when the 
processor demands attention. 

The circuitry is complicated, and if you are 
interested in details, turn to the Technical 
Reference Handbook. In brief, memory is 
accessed by the processor using the Read (RD) 
and Write (WR) lines in conjunction with the 
decoded video area address-select line (VID). 
The display circuitry uses the video memory in a 
more complex manner: characters are output to 
Z27 and Z28, and these in turn are fed to Z29 (a 
character generator) and Z8 (a multiplexer). The 
characters, whether alphanumeric or graphic, are 
fed to Z10 (a shift register), where they are fed, a 
bit at a time, to the video output circuitry 
(beginning at the input of Z30). 
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The character generation process is 
complicated by several factors. The dots that 
make up each letter must be fed to the video 
output circuitry only when the video monitor's 
electron beam is sweeping the visible part of the 
screen. The visible part of the screen does not 
include the upper, lower, left or right borders. 
The timing process must continue correctly even 
when the CPU is using the video memory. 

Because each letter is made up of twelve vertical 
dots, and each line is made up of 64 characters 
with six vertical dots each, different parts of the 
characters must be output to the screen at 
different times. 

Again, the Technical Reference Handbook 
covers this in detail, but a few decoded signals are 
important. The output of Z30, pin 10, is the final 
BLANK signal; no characters are output when 
this signal is active. Presence of characters or 
graphics in the border areas points to problems 
with this line. 

The signal to shift video bits out to the video 
circuit is provided by Z26. Pin 8 controls 
alphanumeric bits, pin 6 controls graphics bits. 
Mangled screen characters may be traced to here, 
or to any of the seven chips that select characters: 
Z65, Z50, Z12, Z32, Z64, Z49, and Z31. This is one 
of the most unpleasant areas to attempt to 
diagnose. 
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The 32/64 character mode select (MODESEL) 
is provided by Z59, pin 9, and changes the speed 
of the video clock at Z43. Failures in either Z59 or 
Z43 will show up as a lockup in one mode or the 
other. 

The presence of bit 7 determines if the 
computer is to output graphics or alphanumerics, 
and that signal (DLY BIT 7) is output in normal 
and inverted forms from Z27 pins 2 and 3. 
Failure in either mode can be examined here, or 
at the outputs of Z26, pins 6 and 8. 



Keyboard 

The keyboard is very different from the video; 
it's just a simple key matrix. When the keyboard 
address area is read, the KYBD line from Z36 pin 
11 triggers the keyboard integrated circuits (Z3 
and Z4 on most keyboards) into action, 
outputting information to the data bus. 

The data to be output is determined by the low 
eight bits of the address requested. The specific 
address requested is inverted, and a low signal is 
detected whenever a key in that matrix row is 
pressed. The inverting buffers to the data line 
provide the appropriate row information. For 
details on how the software interprets this 
switching matrix, see the supplement to this 
Chapter. 
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Figure 2-48. Character generator and shift register. 
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An interesting aspect to this is how the 
depression of any key may be detected. If 
address 387F is sought, all the address lines 
(except SHIFT) will become active, and the 
presence of any depressed key (except SHIFT) 
will appear on the address bus. Requesting the 
data at address 38FF will return the presence of 
any key including SHIFT. This is useful in 
creating a keyboard buffer, which is built from 
characters detected whenever the INTerrupt 
line is triggered. 

In other words, the interrupt line triggers, and 
the program moves to the interrupt service 
routine. This routine reads address 387.F, and 
the presence of any depressed key can be sensed. 
If one is pressed, it can be accepted and 
evaluated. Otherwise, the interrupt routine 
promptly returns to the program in progress. 

This is also a valuable addition to INKEY$ in 
some situations; see 'Peeking the Keyboard' in 
Chapter 3. 

ON KEYBOARD PCB 




ROM Control 

Selecting the ROMs is the biggest sticking 
point in the Model I. This selection is 
accomplished by Z3, another DIP jumper shunt, 
in conjunction with Z21, a 74LS156 
demultiplexer. Z21 joins various address lines to 
produce VID, KYBD, and MEM for the video, 
keyboard, and dynamic RAMs and to produce 
variants on the ROM line. 

Two-chip Level I sets were selected by a 
combination of methods, all of which are detailed 
in the Technical Reference Handbook. Each 
ROM was 2K bytes in size. Three different 
versions of the board were publicly released, 
marked 'A', 'D' and 'G'. Each had a different 
hard wired method of decoding ROM. An 
occasional 'B' or 'F' board has been reported to 
me, but I have never seen one. Follow Technical 
Reference Manual descriptions carefully to 
make sense of these Level I lines. 

Some of these ROMs were EPROMs with 
identical pinouts, so a 'ROM A' and 'ROM B' pair 
of lines were needed so these memories would not 
conflict. 

Later Level I ROMs had the selecting circuitry 
masked right onto the chips, which removed that 
conflict. Finally, a single 4K ROM was 
introduced to eliminate these difficulties 
completely. 
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Figure 2-49. Keyboard matrix of TRS-80, 



+5V GND 
O C2 O 

O.lfiF 
• i — -|(- — 1 1 

CI 
O.itfF 

Mr- 1 

~ I9~ 



The Custom TRS-80 



47 



Output Controls 






©- 






ROM B (M 



s 



The Level II ROMs were for a long time quite 
consistent as a three-chip set, 4K bytes of 
memory in each one. A separate, piggybacked 
board was used. The decoded ROM line, in 
conjunction with address lines 11, 12 and 13, feed 
a 74LS42 wired as a demultiplexer. Each ROM 
selects a bit differently, and the combination of 
signals allows the memory areas from 0000 to 
OFFF, 1000 to 1FFF, and 2000 to 2FFF to be 
selected. 

In later Model I's, the three-chip set was 
reduced to two masked ROMs with different 
select characteristics. The piggyback board 
disappeared, and the two ROM sockets, once 
used for Level I, were now used for Level II. A 
modification to remove the two-chip ROM set, 
and make room for the addition of Level I, is 
presented elsewhere. 

Output Controls 

Some of the output controls have already been 
pointed out, including the parallel-to-serial 
conversion of video characters and the 32 
character video control. The latter is part of a 
latch which is activated by information sent to 
port FF. Z54, Z36 and Z52 together decode port 
FF, and this is brought together with the 
computer's IN and OUT signals. The result is a 
pair of lines marked INSIG and OUTSIG, which 
are used to activate the input/output circuitry. 

A latch, Z59, holds the cassette motor on or off, 
and also locks the video into 32- or 64-character 
mode. It is also latched on and off to create the 
500-baud pulse rate of data to the cassette player. 
This output signal is purely digital, as opposed to 
the input signal (discussed below). 

Z44 



Figure 2-50. 74LS42 Level II demultiplexer of TRS-80. 




Figure 2-51. INSIG and OUTSIG area of TRS-80. 



Figure 2-52. Output data latch area of TRS-80. 
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It would have been possible to have used Z54 to 
decode port FF directly, without using Z52 or 
Z36. Whether or not this was a design expansion 
consideration, you can use it as such since ports 
FF (255 decimal) and FE (254 decimal) are 
created by Z54 and the separate low-bit data line. 
In Chapter 4 port FE will be used for video and 
speed changes. 

Cassette input is provided via a low-pass filter, 
through parts of Z4, where it is turned from low 
grade audio into a reasonable digital signal. 



When INSIG is activated, whatever data is 
present at the cassette input is switched onto the 
data bus, and the CPU can read it. Then 
OUTSIG may reset the flip-flop created by Z24, 
when the program is ready to read the next piece 
of data from the cassette input. Note that the 
input can be any audio signal. The cassette port 
is not limited merely to taped data, but can be 
used to decode communications, shortwave, and 
ham transmissions, or test for the rise of voltage 
to a triggering level. 
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Figure 2-53. Cassette data shaping circuit of TRS-80. 




The Custom TRS-80 



49 



Power Supply 



The complex video divider chain provides 
HDRV and VDRV (horizontal and vertical 
drive) signals for television monitor 
synchronization. These signals are fed into a 
group of digital phase-shifting circuits which 
permit the signal to be adjusted on the video 
screen. 
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Figure 2-54. Horizontal and vertical phase circuitry. 



The signals are mixed together at Z5 to provide 
a complete syncronization signal, and this sync 
signal is mixed with the video signal by Z41, Ql 
and Q2. The result is a composite video signal 
which is capable of running a standard television 
monitor, or an RF modulator. The RF modulator 
signal can then drive an ordinary television. 
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Figure 2-55. Video mixing circuit of TRS-80, 

Power Supply- 
Refer to the Technical Reference Handbook 
for an excellent description of this circuitry. 
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1. Insert stripped wire. 




Sti p over pin. 
HoLci wire firmly , 
ana BLiae futty uowi 
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Wire-Wrapping Technique 

It's not without a bit of hesitation that I 
attacked many of the hardware projects 
presented in this book. Some are simple, but 
many, particularly those using memory circuits, 
need many connections. The wiring is not 
complicated, just-tedious. 

If you work carefully, all is likely to be well; 
but even a touch of haste will encourage 
confused connections. It is in these cases 
especially that wire-wrapping is the technique 
to use. 

Wire-wrapping is not only easier than 
soldering, it is secure, simple, easier for 
correcting mistakes - and less costly. For 
wire-wrapping, you will need wire-wrap sockets, 
which are sold by most hobbyist supply houses 
including Radio Shack. Likewise, wire-wrap 
wire and a simple hand tool are used for the 
process. Here are the steps: 



1. The wire, still connected to the spool, is 
inserted in the V-shaped stripping slot. 
Insert between one half and one inch of wire. 

Pull downward from the V, and the wire will 
slip out, leaving a piece of insulation in the 
stripper, where it can be shaken out. 

2. Look carefully at the end of the 
wire-wrap tool. There is a small hole, meant 
to fit over the pins of a wire-wrap socket. 
Next to it is a half-circle, into which you 
must slide the stripped wire. The stripped 
portion will slide up a groove in the side of 
the tool, stopping where the insulation 
begins. 

3. When the wire is in place, pull it 
sharply but gently upward, and slide the tool 
on the wire-wrap socket. Holding the wire 
firmly, spin the tool in your hand. The wire 
will wind up on the socket pin, freeing itself 
from the tool. Remove the tool. The 
wire-wrapping is complete for that end of 
the connection. 

4. Cut the wire to a length that will 
comfortably reach its destination, and then 
some. Strip the end of it, and repeat the 
process above. The connection is complete. 
Don't forget to use different colors (white, 
yellow, red and blue are generally 
available) .This will help you distinguish your 
connection patterns if changes become 
necessary. 



Peripheral Addressing 

The bulk of the external devices attached to 
the TRS-80 do their own address decoding work. 
Some have become standardized by conventions 
of their use, and others have been used somewhat 
haphazardly by various manufacturers. 



Table 2-6 
Addressee reserved: 



30Q0-37CF 



37DE 
37DF 
37E0 
37E1 
37E4 
37EB 



37 EC 
37F8 



Exetron Stringy-Floppy 
Personal Microcomputer Festload 
Personal Microcomputer REX-BO 
Peripherel People Memory Sidecar 

Communications Status [Expansion) 
Communications Data (Expansion) 
Interrupt Flip-FLop (Expansion) 
Disk Drive Select Latch (Expansion) 
Cassette Drive Select (Expansion) 
Line Printer I/O (Expansion) 
Percom Electric Crayon I/O 
Percom Speak-2-Me-2 
Hicrocompatible Printer Buffer 
Floppy Disc Controller [Expansion) 
Electronic Systems Serial I/O 

Table 2-7 

Output Ports Reserved: 



[Selectable 

1 (SelectebU 

2 (Selectebli 
7 (Selectable 
B 

55 
208 
SOS 
232 

233 

234 

23b 

254 

255 



Addressable 



) Alpha Product Interface Devices 
) Alpha Product Interfece Devices 
) Alpha Product Interface Devices 
) Alphe Product Interface Devices 
JPC Poor Man's Floppy System 
Electronic Systems Serial I/O 
Microperipheral Microconnection 
Microperipherel Microconnection 
Lynx Modem 

Redio Sheck RS-232 Board 
Lynx Modem 

Radio Sheck RS-232 Board 
Lynx Modem 

Redio Shack RS-232 Board 
Lynx Modem 

Radio Shack RS-232 Board 
Archbold High Speed Board 
Mumford Micro Speed Mod Board 
Most Internal Ussr Modifications 
Cassette Data I/O (Internal) 
BQ-Grefix (Programma) 
Cessette Motor Switch (Internal) 
Video Character Size Latch (Internet) 
Simutek T-Beep Addition 
Mullen Computer M-80 Interface 
Quant Systems PPI-BO I/O Port 
Orion Instruments In-Circuit Emulator 
OptimaL Technology EPROM Programmer 



Table 2-8 
Other Peripherel Device Uses 
Unaddressed (using bus control signets): 



Cecdet Software/Hardware Extension, The Patch 
Microgramma Programmable Graphics, Grafix-BO 
Microcompetible Company, The 225S Solution 
Alpha Product Stick-80 Joysticks 
SEL IEEE-43B to TRS-80 Interface 
Xitek STD Bus I/O Card System 

Uneddressed (using cassette I/O signals): 



Most evalleble Light Pens, including 
Most eveileble Cessette Data Digitizers, including 
Acu-Date, Data Dubber, E-Z Loader 

Unconnected (using RFI interference pickup): 



Micro-Mege CPU Monitor 
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Soldering Technique 

For projects from scratch, soldering should 
be considered the final process, the actions of a 
self-assured, confident hobbyist. For 
modifications, it is a necessity. In either case, 
and whether you are a micro-acrobat or 
distinctively clumsy like me, you can solder 
well. The requirements are patience and good 
solder. 

To start, make sure you are using an iron in 
the 25 to 40 watt range, never a soldering gun. 
The solder should be high quality, multicore 
solder. It is expensive, but will save many grief 
stricken hours tracing 'cold solder joints', or 
removing globs of dull solder from between and 
under integrated circuits. 

1. Clean the soldering iron tip, and heat 
the iron. Flow fresh solder on the tip to 'tin' 
the tip, which will help the solder flow from 
the tip of the iron to the part to be soldered. 
If the iron has been used, clean any 
encrusted material from the tip, and use 
coarse emery paper to shine the solder. If 
the tip gets deformed, bent, or very 
corroded, file it sharp with a fine file, and 
re-tin the tip. 




Tin the tip. 



2. Keep an old sponge handy, slightly 
damp. Run the tip of the iron quickly over it 
as you solder to remove the excess flux. 
Always use a soldering iron holder (usually 
provided with an iron); if you don't, you'll 
wish you had the first time you burn a large 
hole in your imitation walnut, vinyl-topped 
desk. 




4. FiiH&hecj 

so Lcjor connection. 



3. In the olden days, the rule was 'heat the 
parts, not the solder'. Forget it. Make sure 
the iron is no hotter than 40 watts (and 
remember never to use a soldering gun) and 
that the parts you are about to solder are 
very clean. Place the iron against the part, 
making as much contact with it as possible 
along the angled tip of the iron. Place the 
end of the solder at the juncture of the iron 
and the part, and flow just enough solder to 
make a clean, shiny, flowing connection. 




2. Briny soLcier, parts, ana 
iron into contact. 

4. Remove the iron immediately and let 
the part cool. If a wire is being soldered, 
hold it still until the solder becomes cloudy 
and cool, or else an imcomplete connection 
may result. 




W//f/IMt/rmrMMF///MMttWtt/f'/W'MM. 



3. Lift iron and 

soloer simultaneously . 

5. If solder bridges develop between 
connections that are very close together, 
don't try to suck up the solder with the iron; 
you can only overheat the parts that way, 
and end up with blobs of solder and flux. 

Instead, use solder wick or solder-up to 
remove the excess solder, and start again. 
Let the parts cool before soldering again (a 
half minute should be enough). 




JIHHHi "i3y 




b. Baa solaer connection ■ 
no contact with boaru 
(bioBvtewj , 



Sao so tear connection - 

no contact with pin 

E6A sioeviGvdiea topviewl. 
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On the Keyboard Scan 

Arrows? Control codes? Autorepeat? 
Whatever it is you would like, that has to do with 
the keyboard, you can do with the TRS-80. The 
designers of the machine chose not to use an 
ASCII (Amercan Standard Code for Information 
Interchange) keyboard . . . one that outputs a 
code for each key pressed; instead, the keyboard 
is a matrix of switches. Because of this decision, 
the TRS-80 keyboard can be extremely versatile 
with a minimal body of software. 

First let's take a look at the keyboard matrix 
itself. If you have been programming in machine 
language, or even relatively sophisticated 
BASIC, this map will be familiar: 



address 03EB: 



Addresses 






Keys 






3801 


e 


A 


B 


C 


D E F 


G . 


aaoa 


H 


I 


J 


K 


L M N 


. 


3804 


P 


a 


R 


S 


T U V 


W . 


3808 


X 


Y 


Z 




RESERVED... 




3810 





1 


. 2 


3 


4 5 6 


7 . 


3820 


8 


S 


:* 


; + 


,< -= .> 


/? . 


3B4D 


ENT 


CLR 


BRK 


UPAR 


DNAR LFAR RTAH 


SPC . 


3880 


SHIFT 
01 


OS 


04 


08 


RESERVED 




Data: 


10 20 40 


80 . 



At first, the arrangement of the address lines 
and data information may seem unappealing. 
What is the use of having address and data 
information that doubles at each change? Why 
not just use 3801, 3802,' 3803 and so on? The 
reasons will eventually become apparent - in the 
ease and speed of the keyboard scan (and in the 
low cost of the hardware), but consider this 
binarv for a moment . . . 



00000001 
00010000 



00000010 
00100000 



00000100 
01000000 



00001000 
10000000 



. . . and there you have it. The bit is bumped 
along for each keyboard row and column, so that 
the presence of a single active bit instantly 
identifies any of the (potential) 64 keys. 

The entrance to the keyboard scan is made 
with a jump from address 4016 in the ROM's 
RAM switchboard. Normally at power up, the 
jump address 03E3 is put in place, and the 
keyboard scan is entered at that point. Registers 
BC, DE, HL, and A are used in the scanning 
process: 



03 E3 


21 36 40 


LD 


HL.4036 


03 EB 


01 01 38 


LD 


BC,3801 



The HL register pair points to the first RAM 
location at which the keystrokes will be stored. 
BC is set to look at the first row of the keyboard, 
whose memory map is 3801 to 3880 as noted 
earlier. Register D is set to zero, and it will 
become a 'row counter'; the process begins at 



03 EB 
03EC 



DA 
5F 



LD 
LD 



A.IBC) 
E.A 



The accumulator reads the data at BC (recall 
at the outset it is pointing to the first keyboard 
row, 3801). The information it finds is stored in 
the memory location pointed to by HL (4036). 

Okay so far. Now comes some of the 
interesting stuff that distinguishes this scan as 
an excellent piece of writing: 



03ED 


AE 


X0R 


(HL) 


D3EE 


73 


LD 


(HL),E 


03 EF 


A3 


AND 


E 


03F0 


20 08 


JR 


NZ.03FA 



This short segment is responsible for the 
'rollover' capabilities of Level II. The contents of 
the accumulator (the keystroke, if found) is 
XORed with the previous contents of 4036. 
Recalling how the XOR function works, we 
discover that if the key pressed was the same as 
the previous one at this row, the accumulator will 
be 'toggled' to zero. In any case, the current 
keystroke, whatever it is, is now saved in 4036 (so 
that the next time 'round, it knows if a key is still 
pressed). 

If the key was the same, AND E will be the 
result of A-toggled-to-zero AND the found 
keystroke ... or zero. If there was no key 
pressed, the result will be A XORed with HL 
(which is essentially irrelevant) AND 
E-which-is-zero ... or zero. The test at 03F0 is 
for not zero. Under these conditions, it fails, so 
the program continues: 



03F2 


14 


INC 


D 


03F3 


2C 


INC 


L 


03F4 


CB 01 


RLC 





03F6 


F2 EB 03 


JP 


P.03EB 


03FS 


C9 


RET 





The 'row counter' (D register) is incremented, 
and the low-order byte of HL is incremented (to 
storage address 4037), and the low-order byte of 
BC is rotated. Recalling the keyboard matrix, we 
can see that this command to rotate moves us 
from 01 to 02, from 02 to 04 from 04 to 08, from 08 
to 10 and so on. That keeps track of the row that 
the scan is looking at, and as long as the result of 
the rotate is positive (bit 7 low), the loop will 
travel back to 03EB, where the next row will 
undergo the same testing as each previous one. 

When RLC C shifts the row pointer to 3880, 
then bit 7 will be high (10000000); this is 
'negative' in Z-80 architecture, and the loop falls 
through. Why does it fall through before 
checking the contents of address 3880? Because 
the only thing in this row is the shift key; it does 
not offer a decipherable code by itself, but merely 
modifies the information found when some other 
key is depressed. This explains why, among 
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other peculiarities, INKEY$ does not 
acknowledge SHIFT alone. 

When the loop falls through, the program 
encounters a RETurn from subroutine, which 
directs it immediately back to the rest of BASIC. 
The routine is remarkable, looping through just 
over 100 bytes when the keyboard is clear. 
Although not as time-efficient as obtaining input 
from a memory-mapped ASCII keyboard, it is 
quite speedy, and offers considerably better 
'rollover' than many encoded keyboards. 

When a key is pressed, the program jumps to 
03FA, and is able to provide upper/lower case 
ASCII codes, special functions, and, incredibly 
enough, all of the 'missing' ASCII control codes 
(form feed, ring bell, etc.). Let us now follow it 
through: 



03FA 


5F 


LD 


E.A 


03FB 


7A 


LD 


A,D 


03FC 


07 


RLCA 




03FD 


07 


RLCA 




D3FE 


07 


RLCA 




03 FF 


57 


LD 


D,A 



The position of the keystroke found has been 
stored in register E - recall that this is the 
'column' of the keystroke. The row itself is not 
yet accessible, but the row counter (register D) is 
crucial to determining it. After E is saved, the 
accumulator is loaded with the value in this row 
counter, and rotated to the left three times. For 
those shaky in their binary arithmetic, this is the 
effect: if a decimal number is 045, a left rotation 
makes it 450. This is multiplication by ten. If a 
binary number is 010 (decimal 2), a left rotation 
gives 100 (decimal 4) ... in other words, 
multiplication by two. Therefore, three left 
rotates gives us 2 x 2 x 2, or multiplication by 
eight. That result is saved back in register D. 

The purpose of this clever ploy will soon 
become clear: 



0400 


0E 01 


LD 


C,01 


0402 


79. " 


LD 


A,C ■■ 


0403 


A3 


AND 


E 


U404 


£0 05 


JR 


NZ.040B 



Here the C register is set to 1, sucked up by the 
accumulator, and ANDed with E (remember E 
still contains that keystroke column byte). If the 
result is not zero (that is, if E equals 1), then the 
loop falls through and the program moves on. 
But have a look at what follows: 



0406 14 

0407 CB 01 
0409 18 F7 



INC D 

RLC C 

JR 0402 



What is this about? Well, the D register, which 
contains 8 times the row value, is being 
incremented each time C is being rotated . . . 
making the lower three bits of D serve now as a 
column counter! Whoa, you say, back up there. 



Okay, here it is: the original value in D could have 
been through 6, depending on the row in use. 
When shifted three times, the possible values 
become 00, 08, 10, 18, 20, 28 and 30. Each of these 
possible values, when incremented through all 
seven possible columns, might contain 00 to 07, 
08 to OF, 10 to 17, etc., up to 37. This gives us a 
complete, distinct value to represent each key. 

Now a fairly crude process of hunt-'n-peck 
begins. The status of the SHIFT key is checked, 
and set aside in register B. The demultiplexed 
keystroke value in register D is snapped back 
into the accumulator, and the comparisons take 
off: 



040B 3A B0 38 

040 E 47 
040F 7A 



LD A, (3880) 

LD B,A 

LD A,D 



The character search can be followed through 
several branches; we will start with the most 
straightforward, and progress through some of 
the unique (and little publicized) aspects of the 
TRS-80 keyboard output. 

The program adds 40 to the character value 
(address 0410), and checks if the result is greater 
than or equal to 60 (0412). 



CHAR + 40 is 
Less than 60 
[40+00 to 1F) 



CHAR + 40 is 
B0 or greater 
(40 + 20 to 37) 



S A B C 

H I J K 

P Q R S 

X Y Z 



D E F G 
L M N 
T U V W 



1 2 3 4 5 6 7 

8 9 :* !+ ,< -= .> /"? 

ENT CLR BRK UFA DNA LFA RTA SPC 



If the compare finds a value less than 60, the 
routine rotates the SHIFT key value - which had 
been saved in the B register (0416). If SHIFT is 
released, the value in B is zero, and hence the 
rotate resets the carry flag (0418). The program 
moves directly to the terminal steps at 044B (to 
be discussed later). At this point, the character 
contained in A would be in the range 00+40 to 
1F+40, the ASCII values for upper case (@, A-Z, 
left bracket, separator, right bracket, carat, and 
cursor). This is the software routine that causes 
the bizarre 'inverted' shift pattern on the 
TRS-80 ... no shift for upper case! 

If the character test at 0412 returns a value 
greater than or equal to 60, then 70 is subtracted 
(0429). No carry is generated if the test value was 
greater than or equal to 70, so this further 
separates the keyboard. See the diagram below: 



60 to 6F minus 70 
carries; result 
is F0 to FF 

70 to 77 minus 70 
does not cerry; 
result is 00 to 07 



4 5 
,< -= 



6 7 
.> /? 



ENT CLR BRK UPA DNA LFA RTA SPC 
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At address 043D, the value in the accumulator 
(00 to 07) is rotated left, producing the even 
values from 00 to 0E. The SHIFT byte in B is 
rotated right into the carry flag; if a carry is 
generated, the accumulator value is incremented 
(0442), providing the values 0+1, 2+1, 4+1 and so 
on - in other words, the odd values from 01 to OF. 

What follows is a classic example of machine 
language table look-up. HL is set to 0050, the 
address of the table in ROM; BC will be used as 
an offset, with B set to and C made equal to A. 
When BC is added to HL, a resultant address 
(0050 to 005F) is produced, and the contents of 
that address is loaded up by the accumulator. 
Here is a look: 



0443 


21 50 


00 


LD 


HL,0050 


0446 


4F 




LD 


C,A 


0447 


06 00 




LD 


B,0 


0449 


09 




ADD 


HL.BC 


044A 


7E 




LD 


A,(HL) 


044B 


57 




LD 


D,A 



What do we find at 0050 to 005F? ASCII 
control codes. That result is stored in the D 
register (044B) before the termination sequence. 

Table 2-9 
Address Contents TRS-80 Action ASCII Description Keyboerd Entry 







0050 


0D 


Cerriage Rat. 


Carriage Ret. ENTER 






0051 


0D 


Cerriage Ret. 


Carriage Ret. SHIFT ENTER 






0052 


1F 


Clear Screen 


Unit Separator CLEAR 






0053 


1F 


Cleer Screen 


Unit Separator SHIFT CLEAR 






0054 


01 


Break 


Start of Heading BREAK 






0055 


01 


Break 


Start of Heading SHIFT BREAK 






005B 


5B 


Up Arrow 


Left Bracket Up Arrow 






0057 


1B 


Eait Escape 


Escape SHIFT Up Arrow 






0D5B 


0A 


Line Feed 


Line Feed Down Arrow 






0059 


1A (00) »See text 


Substitute SHIFT Down Arrow 






00 5A 


0B 


Backspace 


BBOkspaoe Left Arrow 






005B 


18 


Backspace Line 


Cancel SHIFT Left Arrow 






Q05C 


09 


Horizontal Tab 


Horizontel Teb Right Arrow 






005D 


19 


32-Char. Mode 


End of Medium SHIFT Right Arrow 






005E 


20 


Space 


Space Space 






0B5F 


20 


Space 


Space SHIFT Space 






00100 


################«###########«###«######«########### 






00110 


SIMPLE ACTIVE KEYBOARD 


DISPLAY ROUTINE TO SHOW THE USE 






00120 


AND PHANT0MING OF KEYS AS THEY ARE PRESSED BY THE USER 






00130 












00140 


DENNIS BATH0RY KITSZ, R0XBURY, VERMONT 05669 






00150 


ttmmmmmmtmtwmtmmmtmmttttmt 






00160 








5000 




00170 
0D1B0 




ORG 5000H 








00190 


########«################«#«#######«###«########## 






00200 


CLEAR 


SCREEN, DISABLE INTERRUPTS, CLEAR ACCUMULATOR, 






00210 


GET ' 


0" CHARACTER, SCREEN POSITIONS, SCREEN OFFSET, 






00220 


AND BEGINNING OF KEYBOARD FOR TEST; ALL ARE SET UP ONCE 






00230 


tttnnttt**t*ttttt§tttttttttt*ttttttittnt*tH*ttt*ttt 






00240 








5000 


CDC901 


00250 


3ITER 


CALL 01C9H 




CLEAR SCREEN TO START 


5003 


F3 


00260 




01 




KILL ALL THEM BOTHERS 


5004 AF 


00270 




XOR A 




CLEAR ALL FLAGS 


5005 


0E30 


002B0 ! 


START 


LD C.30H 




THIS IS THE "0" CHAR. 


5D07 


21103D 


00290 




LD HL.3D10H 




ADDRESS NEAR SCREEN CTR 


500A 


11 £400 


00300 




LD DE,0024H 




DISTANCE BETWEEN LINES 


500D 


D5 


0D310 




PUSH DE 




SAVE LINE ADDER VALUE 


500E 


110138 


00320 




LD DE.3S01H 




DEFINE FIRST KEYBOARD 


5011 


060B 


00330 




LD B.OBH 




NUMBER OF LOOPS TO DO 






00340 












00350 


nmmmmmmmmtmmmmmmtmmm 






00360 


TEST 


EACH ROW OF THE KEYBOARD, COLUMN BY COLUMN 






00370 


Httttttttttttttttitttttttttttttttttttttttttttttttittti 






003BO 








5013 


1A 


00390 


-OOP 


LD A,(DE) 


i FIRST ROW OF KEYBOARD 


5D14 


CB47 


00400 




BIT 0,A 




CHECK FIRST KEY COLUMN 



Alright, we have upper case ASCII and TRS-80 
control functions. How about the rest? Back up 
now to the test for SHIFT, at 0416. If such a shift 
is present, the value in A (40 to 5F) is increased by 
20 (60 to 7F). These are the ASCII codes for lower 
case (@, a-z, left brace, separator, right brace, 
delete). The resultant code, as usual, is saved in 
the D register. 

But what follows is curious: 



041 D 


3A 40 3B 


LD 


A, (3840) 


0420 


E6 10 


AND 


10 


0422 


2B 28 


JR 


Z.044C 



The keyboard is tested again, this time at row 
3840, data position 10 - the down arrow. If that 
key is not depressed, the program skitters right 
to the termination routine at 044C, with the 
lower case ASCII code ensconced in the D 
register. 

Why the SHIFT/down arrow combination? If 
the down arrow is depressed, the value in D is 
retrieved and placed in the accumulator (60 to 
7F), then reduced by 60, becoming . . . aha! . . 
. 00 to IF. The program jumps to the end 
sequence, with the accumulator clutching one of 
the complete set of 32 ASCII control codes! 

(There is an anomoly in earlier Level II ROMs: 
the code for the down arrow at 0059 is returned 
before the control code. Later ROMs placed a 00 
at 0059, resulting only in the return of a control 
code if SHIFT/down arrow was depressed.) 

So where are we now? Upper and lower case, 
TRS-80 and ASCII control codes. We need 
numbers and figures, and so we shall have them. 
Recall the second diagram: at 042B, the 
command row was separated from the numbers, 
which were left at FO to FF. At 042D, 40 is added, 
resulting in possible values of 30 to 3F. A further 
separation is made via a comparison with 3C: 



30 to 3B 

(CP 3C result) 



,< 



7 
/? 



If the comparison is less than 3C, a carry is 
generated. The usual SHIFT test is made (at 
0435), and if it fails, the value in A (30 to 3B) is 
maintained as the program moves into the end 
routine. These are the ASCII codes for numbers 
to 9, colon and semicolon. 

If the test value is 3C, 3D, 3E or 3F, no carry 
would be generated at 042F, and these values are 
XORed with 10. This toggles the high nibble 
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SD16 71 
5017 2801 

5019 34 
501A 23 
501 B 23 
501 C 23 
501 D 23 
501 E CB4F 

5020 71 

5021 2B01 

5023 34 

5024 23 

5025 23 

5026 23 

5027 23 

5028 CB57 
502A 71 
502B 2801 
502D 34 
50 2E 23 
502F 23 

5030 23 

5031 23 

5032 CB5F 

5034 71 

5035 2B01 
5037 34 

5036 23 

5039 23 
503A 23 
503 B 23 
503C CB67 
503 E 71 
S03F 2801 
5Q41 34 

5042 23 

5043 23 

5044 23 

5045 23 

5046 CB6F 

5048 71 

5049 2801 
504B 34 
504C 23 

5040 23 
504E 23 
504F 23 

5050 CB77 

5052 71 

5053 2801 

5055 34 

5056 23 

5057 23 
505B 23 
50 59 23 
5Q5A CB7F 
505C 71 
S05D 2801 
5D5F 34 

5060 05 

5061 DDE1 

5063 01 

5064 19 

5065 05 

5066 DDE5 

5068 01 

5069 CB13 
506 B 10A6 



506D D1 
506E 01000B 
5071 CD6000 
5074 1B8F 



5000 

00000 TOTAL 

31044 TEXT 



00410 

00420 

00430 

00440 JUMP1 

00450 

00460 

00470 

00480 

00490 

00500 

00510 

00520 JUMP2 

00530 

00540 

00550 

00560 

00570 

00580 

00590 

00600 JUMP3 

00610 

00620 

00630 

00640 

00650 

00660 

00670 

00680 JUMP4 

00690 

00700 

00710 

00720 

00730 

00740 

00750 

00760 JUMP5 

00770 

00780 

00790 

ooaoo 

00610 

00820 

00830 

00840 JUMP6 

00B50 

00860 

00B70 

008B0 

00B90 

00900 

00910 

00920 J0MP7 

00930 

00940 

00950 

00960 

00970 

00980 

009S0 

01000 JUMPS 

01010 

01020 

01030 

01040 

01050 

01060 

01070 

01080 

01090 

01100 

01110 

01120 

01130 

01140 

01150 

01160 

01170 

011 80 

01190 

01200 
ERRORS 
AREA BYTES LEFT 



LD 

JR 

INC 

INC 

INC 

INC 

INC 

BIT 

LD 

JR 

INC 

INC 

INC 

INC 

INC 

BIT 

LD 

JR 

INC 

INC 

INC 

INC 

INC 

BIT 

LD 

JR 

INC 

INC 

INC 

INC 

INC 

BIT 

LD 

JR 

INC 

INC 

INC 

INC 

INC 

BIT 

LD 

JR 

INC 

INC 

INC 

INC 

INC 

BIT 

LD 

JR 

INC 

INC 

INC 

INC 

INC 

BIT 

LD 

JR 

INC 

PUSH 

POP 

POP 

ADD 

PUSH 

PUSH 

POP 

BL 

DJNZ 



(HLJ ,C 

Z.JUMP1 

(HL) 

HL 

HL 

HL 

HL 

1,A 

(HL1,C 

2,JUMP2 

(HL) 

HL 

HL 

HL 

HL 

2, A 

IHU.C 

Z.JUMP3 

(HL) 

HL 

HL 

HL 

HL 

3, A 

(HLJ.C 

Z.JUMP4 

(HL) 

HL 

HL 

HL 

HL 

4,A 

(HLJ.C 

Z.JUMP5 

IHU 

HL 

HL 

HL 

HL 

5, A 

(HLJ.C 

Z, JUMPS 

(HL) 

HL 

HL 

HL 

HL 

6, A 

[HL1.C 

Z.JUMP7 

(HL) 

HL 

HL 

HL 

HL 

7, A 

(HLJ,C 

Z, JUMPS 

[HL! 

DE 

IX 

DE 

HL.DE 

DE 

IX 

DE 

E 

LOOP 



FIRST DISPLAY A "0" 

OON'T CHANGE IF NO KEY 

MAKE IT A "1" IF A KEY 

NEXT SCREEN LOCATION 

...PLUS TWO 

...PLUS THREE 

...PLUS FOUR 

SECOND KEYBOARD COLUMN 

FIRST DISPLAY A "0" 

DON'T CHANGE IF NO KEY 

MAKE IT A "1" IF A KEY 

NEXT SCREEN LOCATION 

...PLUS TWO 

...PLUS THREE 

...PLUS FOUR 

THIRD KEYBOARD COLUMN 

FIRST DISPLAY A "0" 

DON'T CHANGE IF NO KEY 

MAKE IT A "1" IF A KEY 

NEXT SCREEN LOCATION 

...PLUS TWO 

...PLUS THREE 

...PLUS FOUR 

FOURTH KEYBOARD COLUMN 

FIRST DISPLAY A "0" 

DON'T CHANGE IF NO KEY 

MAKE IT A "1" IF A KEY 

NEXT SCREEN LOCATION 

...PLUS TWO 

...PLUS THREE 

...PLUS FOUR 

FIFTH KEYBOARD COLUMN 

FIRST DISPLAY A "0" 

DON'T CHANGE IF NO KEY 

MAKE IT A "1" IF A KEY 

NEXT SCREEN LOCATION 

...PLUS TWO 

...PLUS THREE 

...PLUS FOUR 

SIXTH KEYBOARD COLUMN 

FIRST DISPLAY A "0" 

DON'T CHANGE IF NO KEY 

MAKE IT A "1" IF A KEY 

NEXT SCREEN LOCATION 

...PLUS TWO 

...PLUS THREE 

...PLUS FOUR 

SEVENTH KEYBOARD COLUMN 

FIRST DISPLAY A "0" 

DON'T CHANGE IF NO KEY 

MAKE IT A "1" IF A KEY 

NEXT SCREEN LOCATION 

...PLUS TWO 

...PLUS THREE 

...PLUS FOUR 

EIGHTH KEYBOARD COLUMN 

FIRST DISPLAY A "0" 

DON'T CHANGE IF NO KEY 

MAKE IT A "1" IF A KEY 

SAVE THIS VALUE 

PUT IT IN IX FOR A BIT 

GET ORIGINAL DE VALUE 

NOW START NEXT LINE 

SAVE SAME VALUE AGAIN 

STASH IT BRIEFLY 

AND BACK INTO DE INTACT 

DEFINE NEXT KEYBRD ROW 

DO IT FOR EIGHT ROWS 



from 3 to 2, resulting in values from 2C to 2F (, - 
. /). If a shift key was noted at 0437, the same 
toggle procedure is followed, changing values 30 
to 3B into 20 to 2B (these would become space ! 
"#$()*= etc.). 



CLEAR UP POINTERS AND DELAY SO SCREEN DOES NOT JITTER 

MttttttttttttttttttttttttttttttttttmttnttHtttttttt 



042D 


C6 40 


ADD 


A, 40 


042F 


FE 3C 


CP 


3C 


0431 


3B 02 


JR 


0,0435 


0433 


EE 10 


XOR 


10 


0435 


CB 08 


RHC 


B 


0437 


30 12 


JR 


NC.044B 


0439 


EE 10 


XOR 


10 


043 B 


18 OE 


JR 


044B 



Thus, the coding is complete: control codes (00 
to IF), punctuation (20 to 2F), numbers and 
figures (30 to 3F), upper case (40 to 5F) and lower 
case (60 to 7F). Just as an aside, the terms lower 
and upper case are sometimes written small and 
large case; old-time printers would chuckle at 
that. The case referred to is a printers case, 
which, when two were stacked one above the 
other, contained the capital and small letters. 
Thought you might like to know that. 

Back to the routine, starting at the termination 
sequence (044C); the decoded character is saved 
in D, and that is the only information we need to 
preserve, since the bulk of the work is done. 



044C 


01 AC OD 


LD 


BC.ODAC 


044F 


CD 60 00 


CALL 


0060 


0452 


7A 


LD 


A,D 



POP 
LD 

CALL 
JH 



DE 

BC.SOOH 
0060H 
START 



CLEAR THE STACK 
DELAY VALUE 

DELAY SUBROUTINE IN ROM 
START THE ROUTINE AGAIN 



A delay at 0060 is called, which was intended to 
wait through the bounce present with normal 
mechanical switch contacts - but the easily 
dirtied switches on the TRS-80 are abnormal! 
This delay uses the accumulator, and when it is 
free, the value in D is restored to it. This value is 
compared to 01 (the BREAK code), and returns 
directly to the main routine (0455) with any code 
other than BREAK. 

If BREAK is discovered, the program executes 
a call to 0028 (RST 28), returning to Level II. 

The routine is quite efficient, and is capable of 
returning 128 different values at a rate of better 
than 100 per second - ten times the speed of the 
world's fastest typist! 



MtmuttMt>tttttttntmnMttttttttttt*ttttt*nttti 

END ENTER ; BEGIN IT ALL HERE 



ENTER 

JUMP1 

JUMP2 

JUMP3 

JUMP4 

JUMP5 

JUMP6 

JUMP7 

JUMPB 

LOOP 

START 



5000 00250 
501A 00440 
5024 00520 
502E 00600 
503B 00660 
5042 00760 
504C 00840 
5056 00920 
506D 01000 
5013 0D390 
5005 0028D 



01200 
00420 
00500 
00580 
00660 
00740 
00820 
00900 
00980 
0108D 
01170 
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Software Modifications 

Software makes the computer. With that in 
mind, it's not hard to understand the popularity 
of the TRS-80. Its BASIC is simple to use and 
immediately accessible. It reports back errors 
and provides clear screens and graphics with easy 
commands. At first, it was hard to imagine how 
such an elegant BASIC could be improved. 

Such illusions could not last long, especially 
when weakly designed hardware started to 
exhibit keybounce, when machine language 
software was so fast but so difficult to access, 
when putting a program aside meant losing all 
variables, and so forth. 

In this Chapter, several simple but very 
important software modifications will be 
presented : 

Keyboard debounce with repeating keys, 
audible beep tone, and an upper/lower case 
driver. 

Two methods of intercepting the BASIC 
interpreter in order to create your own 
commands. 

Packing machine language programs in 
simple BASIC strings, where they can be 
moved about and accessed easily. 

Sound and sound-effects generation 
routines. 

Creating somewhat unlistable BASIC 
programs. 



Auto-execution of SYSTEM programs, 
including an auto-load BASIC module. 

A simple machine language monitor 
accessible directly from BASIC. 

BASIC is not an incomprehensible, 
immutable, indivisible whole, but rather a pliant, 
carefully sewn, patchwork quilt of useful 
subroutines. These routines are accessed singly 
or as groups, not only whenever one of this 
BASIC'S English-language commands is entered, 
but even while waiting for commands to be 
entered or programs to be run. 

Chapter 1 contained an overview of the 
structures that BASIC is composed of; below is a 
more detailed look at the building blocks out of 
which Level II is created. 

1. A power-up sequence: including 
preparation of blocks of reserved memory, 
clearing of internal hardware systems, and 
total memory examination. 

2. Numeric conversion routines: single 
precision to integer and vice versa, numeric 
to string and vice versa, assignment of levels 
of precision. 

3. Simple arithmetic operations: addition, 
subtraction, multiplication, division, 
comparison, and raising to a power 
(exponentiation); integer, single, and 
double-precision calculations. 
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4. Mathematical functions: activities based 
on the sine function, as well as logrithms, 
square roots, absolute value and truncation, 
and random number generation. 

5. String operations: concatenation and 
truncation of strings, direct keyboard scan 
conversions (INKEY$), alphabetic 
comparisons. 

6. Variables: assignment of numeric, string, 
and array variable names, variable 
assignments (LET), updating of values, 
searching for variable names. Partly 
integrated with NEW routines. 

7. Keyboard input: polling of the keyboard 
matrix, conversion to characters, searching 
for carriage return, building a keyboard 
buffer. 

8. Cassette input/output: motor relay 
control, assembly of parallel data into serial 
form, timing of output pulses, timing of 
input, reassembly of data from serial to 
parallel form. 



Listing 3-1. Custom BASIC interpreter patch routine. 



4016 
4016 
300D 



06CC 
4036 
3801 
40tA 
4099 
0060 



00100 
00110 
001S0 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
00320 



ttttttttttlttftttltH*ttttHH*Htt»tHtt**lttttftttttt 

DEB0UNCE. AUTO-REPEAT, AND BEEP KEYBOARD PATCH ROUTINE. 
THIS ROUTINE AS WRITTEN PATCHES INTO 4016. TO USE 
OTHER DRIVERS SUCH AS LOWERCASE, GRAPHICS, ETC.. THE 
RETURN ADDRESS (NORMALLY 03E3] MUST BE REPLACED BY THE 
ADDRESS OF THE OTHER DRIVER. ALSO, TO USE THIS ROUTINE 
WITH THE CUSTOM INTERPRETER /ON AND /OUT COMMANDS BY 
PATCHING THIS DRIVER IN PLACE WITH /ON AND THE NORMAL 
(OR UPPER/LOWER, ETC.) DRIVER IN PLACE WITH /OUT. 



BASIC2 
KEYHLD 
KEYBRD 
HOLDER 
INKEYS 



00330 DELAYS 
00340 



ORG 

DEFW 

ORG 



EQU 
EQU 
EQU 
EQU 
EOU 
EQU 



4016H 

ENTREE 

3000H 



06CCH 
4036H 
3801H 
401AH 
4099H 
0060H 



3000 
3001 



EB 

210B3 
3004 221640 
3 007 E1 
3008 C3CC06 



300B 213640 
300E 010138 
3011 1600 
3 013 OA 
3014 5F 
3 015 A3 
3016 2018 
3019 77 
3019 14 
301A 2C 
301B CB01 
301D 79 

D680 
20F1 



301 E 
3020 



00350 

00360 

00370 

003B0 

00390 ENTREE 

00400 

00410 

00420 

0043 

0440 

00450 

00460 

00470 

00480 

00490 START 

00500 

00510 

00620 CHKKEY 

0053 

00540 

00550 

00560 

00570 INCD 

00580 

00590 

00600 

00610 

00620 

00630 

00640 



ttttttttt»ttll*ltitt**t*tttlt- 
ROUTINE BEGINS HERE, PATCHING 



KEYBOARD SCAN PATCH 
START OF DEBOUNCE ROUT. 
NOTE THAT THIS UTILITY 
IS CURRENTLY SET UP FOR 
USE WITH A MEMORY ADD'N 
AT 3000H. IT CAN BE 
RE-ORGED AT ANY LOC'N. 
BASIC "READY" DISPLAY 
NORMAL KEYSTROKE STORE 
FIRST KEYBOARD ADDRESS 
RESERVED BYTE FOR DELAY 
INKEYS STORAGE BYTE 
ROM DELAY SUBROUTINE 

>ttt*tttttttlttittH»tttlt 

ITSELF INTO PLACE AT 4016 



tlttHttt**lttit**t*ttt*tttKttttttttttttttttttttt*tt»ti 



PUSH 

LD 

LD 

POP 

JP 



HL 

HL, START 

(4Q16H) ,HL 

HL 

BASIC2 



SAVE HL IF TRANSPARENT 
GET START OF ROUTINE 
PUT INTO KEYBOARD PATCH 
RESTORE HL VALUE 
AND GO BACK TO "READY" 



tt****titt*Ht*t**tttt**ttitH*tttHttttttttt*tttt**ttt 

THIS AREA MAKES THE PRELIMINARY CHECK OF KEYBOARD ROWS 
ttitttttttltltllttlttttttltffttttttftt*tttt*tti*tttit*l 



LD 

LD 

LD 

LD 

LD 

AND 

JR 

LD 

INC 

INC 

RLC 

LD 

SUB 

JR 



HL, KEYHLD 

BC, KEYBRD 

D,0 

A.(BC) 

E,A 

E 

NZ.CKPREV 

(HL) ,A 

D 

L 

C 

A,C 

8DH 

NZ. CHKKEY 
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SET UP STORAGE AREA 
SET UP FIRST KBD ROW 
SET UP COUNTER OF ROWS 
FIND IF A KEY PRESSED 
SAVE VALUE IN E REG. 
TEST IF KEY WAS PRESSED 
IF YES, SEE IF SAME ONE 
SAVE VALUE IN STORAGE 
INCREMENT ROW COUNTER 
INCREMENT STORAGE AREA 
SHIFT TO NEXT KBD ROW 
GET VALUE OF KBD ROW 
CHECK IF SHIFT KEY ROW 
IF NOT THEN CONTINUE 



>ttHtHttffttiHlttlttltfi 

Listing Continued , . 



9. Video input/output and display 
management: screen clear, scrolling, 
tabbing, character display including line 
feed, carriage return, backspace, set/reset, 
POS, POINT, cursor control, characters per 
line. 

10. Printer control: lines per page, top of 
form, output of characters, waiting for 
handshake. 

11. A command interpreter for organizing 
the entry points and order of chosen 
subroutines. 

12. Error reporting routines. 

13. Program line management routines. 
Partly integrated with NEW routines. 

14. Editing functions: Insert, delete, kill, 
exit, etc. Integrated in part with program 
line managment routines. 

15. Run-time management: Integrated with 
most of the above functions, but including 
subroutine handling, loop handling, etc. 

A more complete rundown on the TRS-80 
Level II ROM memory map can be found in 
Inside Level II, Supermap, Microsoft BASIC 
Decoded, and TRS-80 Disassembled Handbook 
(see Appendix II for details). 



Sophisticated Debouncing 

The first few hundred thousand TRS-80's 
were afflicted with serious keybounce problems - 
the appearance of double letters when only a 
single letter was typed. Full-scale preventive 
maintenance is presented in the following 
chapter; but there are software solutions as well. 
If debounce were the only criterion, though, 
maintenance would be the ideal solution. 

But the software designers made no provision 
for repeating keys, nor did the hardware 
designers include access to lower case characters. 
Furthermore, the silent keyboard remains a 
frustration to touch-typists and others who do 
not refer constantly to the screen for feedback. 

Thus, some sort of audible reinforcement (as 
with the Apple's entry-error beep) would be a 
thoughtful addition to the keying process. 

Listing 3-1 is a complete debounce, audible 
beep, key repeat, and upper/lower case driver 
routine. The program is written as three 
independent subroutines, each of which may be 
disabled or removed before assembly. 



Chapter 3 



Upper/Lower Case Driver 



Continued Listing 



3022 0607 

3024 2D 

3025 B6 

3026 10FC 
3028 A7 

3023 3E00 
302B CO 
302C 321A40 
302F C9 



3030 A6 

3031 281F 
3033 3A9940 

3036 A7 

3037 20E0 

3039 3A1A40 
303C 3C 
303D 321A40 

3040 FEFF 
3042 2B0S 



3044 C5 

3045 06FF 

3047 00 

3048 10FD 
304A C1 
304B 18CC 
304D 3D 
304E 321A40 

3051 7B 

3052 73 



3053 C5 

3054 010002 
3057 CD6000 
305A C1 
305B OA 
305C A3 
305D C8 



305E 
305F 
3060 
3061 
3063 
306S 
306B 
3069 
3068 
306C 
306D 
306F 
3070 
3072 
3073 
3075 
3077 
3078 
307A 
307B 
3 07C 
307D 



C5 

E5 

F5 

0640 

3A3D40 

EBFD 

67 

F602 

6F 

70 

D3FF 

7C 

D3FF 

C5 

0640 

10FE 

C1 

10F2 

F1 

E1 

C1 

C3FB03 



BASIC2 

CHKKEY 

CKPREV 

DECA 

DECL 

DELAYS 

ENTREE 

WILDER 

INOD 

INKEYS 

KEYBRD 

KEYHLD 

LOOP 

START 

STORE 

TP.WSTE 



DSCC 
3013 
3030 
3D4D 
3024 
0D60 
3U00 
401A 
3019 
4089 
3B01 
4036 
30BG 
30DB 
3052 
3047 



00650 
00660 
00670 
00680 
00690 
00700 
00710 
00720 
00730 

007 40 
00750 
00760 
00770 
00780 
00780 
OOBOO 
0OB10 
00820 
00830 
00840 
00850 
00860 
00B7O 

008 80 
00880 
00900 
00910 
00920 
00930 
00940 
00950 
00960 
00970 
00880 
00890 
01000 
01010 
01020 
01030 
01040 
01050 
01060 
01070 
01080 
01090 
01100 
01110 
01120 
01130 
01140 
01150 
01160 
01170 
01180 
01190 
01200 
01210 
01220 
01230 
01240 
01250 

0126 

0127 
01280 
01290 
01300 
01310 
01320 
01330 
01340 
01350 
01360 
01370 
01380 
01380 
01400 
01410 
01420 
0143 
01440 
01450 
01460 
01470 
01480 

00280 
0U520 
00B2U 
01030 
00690 
00330 
00390 
00310 
00570 
DU320 
00300 
00 290 
01330 
0D490 
01060 
00990 



CHECKING IS DONE - NOW SEE IF PREVIOUS KEYS HELD DOWN 

ttttlttttttittttlHltlttlilttttlttitlliHlttttttttttttt 



ELSE GET NUMBER OF ROWS 
HOVE BACK THRU STORAGE 
AND MAKE TOTAL OF KEYS 
AND DO IT FOR ALL ROWS 
TEST IF ANY KEYS STORED 
A=0, FLAGS REMAIN SAME 
BACK IF KEY IN STORAGE 
SAVE NEW VALUE IN GTR . 
AND BACK TO MAIN ROUT. 



LO 


B,7 


DEC 


L 


ADD 


A,!HL] 


DJNZ 


DECL 


AND 


A 


LD 


A,0 


RET 


NZ 


LO 


[HOLDER 


RET 





NEXT TEST IS FOR STATUS OF INKEYS, 

lttl*t»IHHttittttHHHIt§tttttl 



ttt§itltHiitttttit»i 
IF IT IS IN USE 



CKPREV AND 
JR 
LO 
AND 
JR 
LD 
INC 
LD 
CP 
JR 



(HLJ 

Z, STORE 

A, (INKEYS) 

A 

NZ.INCD 

A, (HOLDER) 

A 

(HOLDER! ,A 

OFFH 

Z.DECA 



SEE IF VALUE IS SAME 
STORE VALUE IF ZERO 
FIND VALUE AT INKEYS 
SEE IF SOMETHING THERE 
IF SO THEN GO AWAY 
GET DELAY COUNTER VALUE 
INCREMENT THE COUNTER 
AND SAVE VALUE BACK 
IS COUNTER AT END YET? 
IF SO, THEN REPEAT 



tttt*tt*t*tnttnnttttttttittttttttttetttnttttnttni 

REPEATING-KEY TIME-WASTE VALUE (FF) MAY BE VARIED 

tttitittt**ttttttntititntitttnntitttttittttttttettt 



PUSH 

LD 

NOP 

DJNZ 

POP 

JR 

DEC 

LD 

LD 

LD 



BC 
B.OFFH 

TMWSTE 

BC 

INCD 

A 

(HOLDER) .A 

A.E 

(HL) ,E 



SAVE BC FOR LATER 

GET DELAY VALUE 

WASTE SOME TIME 

AND DO IT FF TIMES 

RESTORE BC VALUE 

AND BO BACK TO SCANNING 

MAKE A BECOME FE 

AND SAVE IT IN DELAY 

GET KEYSTROKE FOUND 

AND PUT IT IN STORAGE 



tHtt*HttltttlttlltitlitHtt*§tltitHttttttttttttttttt 

DEBOUNCE BELOW MAY BE ELIMINATED BECAUSE BEEP USES TIME 
ttittttttltlttttttHtHtttttttHtlttmHMHtiltHtttlt 



SAVE VALUE IN BC 
GET DEBOUNCE DELAY 
AND CALL ROM DELAY 
AND GET VALUE TO BC 
GET VALUE AT KEYBOARD 
AND TEST IF IT'S THERE 
IF NOT IT WAS BOUNCE 



ttttttltHilttti*ttt*ttiit*ltttitt*ttttttttttttttt»tU 

BEEP ROUTINE PRODUCES VERY SOFT [NOT ANNOYING) SOUND 
HttttltttttltititHtlWttlttttttlttlitttHUtttttHtt 



PUSH 


BC 


LD 


BC.200H 


CALL 


DELAYS 


POP 


BC 


LD 


A,(BC) 


AND 


E 


RET 


Z 



PUSH 

PUSH 

PUSH 

LD 

LD 

AND 

LD 

OR 

LD 

LD 

OUT 

LD 

OUT 

PUSH 

LD 

OJNZ 

POP 

DJNZ 

POP 

POP 

POP 

JP 



BC 

HL 

AF 

B.40H 

A,(403DH) 

OFDH 

H.A 

2 

L,A 

A.L 

(OFFH) ,A 

A,H 

(OFFH) ,A 

BC 

B.40H 

$+0 

BC 

LOOP 

AF 

HL 

BC 

03FBH 



END BASIC2 

00430 014B0 

DU620 

00550 

U0910 

00710 

01140 

00220 

0075U 00B70 00B90 01040 

OOBBO 01020 

00840* 

00500 

00490 

01410 

00400 

00830 

01000 



ELSE SAVE THE VALUE 
AND SAVE THE LOCATION 
AND SAVE THE KEYSTROKE 
AND KEY BEEP DURATION 
AND GET SCREEN STATUS 
AND MASK OUT ALL BITS 
SAVE WAVE "0" MASK IN H 
CREATE A WAVE "1" MASK 
SAVE WAVE "1" MASK IN L 
GET THE WAVE "1" MASK 
AND CREATE WAVEFORM 1 
GET THE WAVE "0" MASK 
AND CREATE WAVEFORM 
SAVE THE DURATION VALUE 
GET THE PITCH VALUE 
AND WAIT THRU WAVEFORM 
RESTORE THE DURATION 
AND DO FOR FULL BEEP 
RESTORE KEYSTROKE VALUE 
RESTORE STORAGE VALUE 
RESTORE COUNTER VALUE 
AND RETURN TO KEYSCAN 

iittttitttttitttttttttlt 



This routine patches into the keyboard control 
block driver address at 4016, leading the program 
to its own entry point instead of 03E3 (see the 
Supplement to Chapter 2 for details on the 
operation of the TRS keyboard scan). 

At START, the keyboard scan begins with HL 
pointing to the first position in a keystroke 
storage buffer (4036). BC points to the first 
keyboard row (3801). The program proceeds 
similarly to the normal Level II scan, except that 
a location (401A) has been set aside to 'count 
down' the time a key remains pressed. If any key 
or combination of keys remain pressed for the 
duration of the loop, the character (normally 
rejected by Level II's rollover capabilities) is 
accepted again. This is the start of the repeating 
process. The INKEY$ storage area is checked 
(so that programs using INKEY$ are not delayed 
by an unusable character acceptance), and a 
short debounce-delay loop is entered. 

If a legitimate key is found, a different 
debounce-delay loop is entered, and a 
rapidly-fluctuating one-zero pattern is sent to 
the cassette port (FF). This sounds as a beep if 
an amplifier and speaker are connected. The 
routine can be exited before the beep, so only the 
debounce-repeat options are present; it can also 
be exited after the beep, returning to the main 
routine with the keystroke. 

The final portion of the program is an 
upper/lower case driver program. This driver is 
irrelevant unless you have a lower case 
modification in place, and should be disabled (or 
not assembled) if you have not made the 
modification. It merely strips the conversion to 
upper case normally made by the Level II 
software, and returns to the running program 
with the actual key depressed instead of an upper 
case converted version. 

Upper/Lower Case Driver 

When the TRS-80 keyboard is used, all 
characters are automatically converted to upper 
case before being displayed. The keyboard itself, 
however, returns a full upper/lower case value 
(albeit inverted - shift for lower case) to the 
display routine. The display routine then sends 
this information to the screen. The screen always 
displays upper case because the hardware to 
provide lower case was not a part of the TRS-80 
as sold. The addition of a single integrated 
circuit (see Chapter 4) provides this access. 

The lower-case driver patches into the display 
routine just as the character to be displayed is 
returned in the accumulator. Control is taken 
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00100 


############ 


tttltHlttttltltttt 


####f#S#####f###f ##«###* 






00110 


SIMPLE LOWER 


-CASE DRIVER ROUTINE FOR BASIC AND DOS 






00120 


ltttlltl»ttltHt*t***l*H*t*tt**tttttltlttttt**tHlttt* 






00130 










7F00 




00140 
00150 




ORG 


07F00H 


NEAR TOP OF BASIC 






00160 


«### 


ttttttt*ttttH*tttitti*»ttttH»tttl»*ttttftttftt*t 






00170 


GET CONTROL 


BLOCK FOR SCREEN AND CHANGE CHARACTERS 






00180 


ttttt 


########«#######«»(!##««####«###«##»#««## 






00190 










7F00 


DD6E03 


00200 


-CDRIV 


LD 


L, [IX+3J 


IX POINTS TO DEVICE 


7F03 


DD6604 


00210 




LD 


H.IIX+4) 


CONTROL BLOCK CVIDEO) 


7F06 


DA9A04 


00220 




JP 


C0 4SAH 


BACK TO SCREEN DRIVER 


7F09 


DD7E05 


00230 




LD 


A,(IX+5) 


GET CURSOR CHARACTER 


7F00 


B7 


00240 




OR 


A 


CHECK IF CURSOR IS ON 


7F0D 


2801 


00250 




JR 


Z.GETCHR 


GET ONE IF CURSOR OFF 


7F0F 


77 


00260 




LD 


IHL) ,A 


PUT CURSOR INTO POSN. 


7F10 


79 


00270 C 


jETOHR 


LD 


A,C 


GET CHARACTER TO SHOW 


7F11 


FE20 


00280 




CP 


20H 


SEE IF A CONTROL CODE 


7F13 


DA0605 


00290 




JP 


C0506H 


BACK TO DRIVER IF C.C. 


7F16 


FEBO 


00300 




CP 


BOH 


SEE IF GRAPHIC CHAR. 


7F1B 


D2A604 


00310 




JP 


NC.04A6H 


BACK TO DRIVER IF SO 


7F1B 


FE5B 


00320 




CP 


05BH 


CHECK UPPER/LOWER CASE 


7F1D 


300S 


00330 




JR 


NC.CHECK1 


IF >5B, CHECK FURTHER 


7F1F 


FE40 


00340 




CP 


40 H 


CHECK UPPER CASE 


7F21 


3B0E 


00350 




JR 


CGOAWAY 


IF<40, CHECK NO FURTHER 


7F23 


C620 


00360 




ADD 


A.20H 


IF 40-5B, HAKE UPPER 


7F25 


1B0A 


00370 




JR 


GOAWAY 


DONE - BACK TO DRIVER 


7F27 


FE7B 


00380 ( 


:hecki 


CP 


7BH 


SEE IF ALPHABETIC 


7FSS 


3006 


003S0 




JR 


NC, GOAWAY 


NO FURTHER IF NOT ALPHA 


7F2B 


FE60 


00400 




CP 


60H 


SEE IF ALPHABETIC 


7F2D 


3B02 


00410 




JR 


CGOAWAY 


NO FURTHER IF NOT ALPHA 


7F2F 


0620 


00420 




SUB 


20H 


PLAY SWITCH TO LOWER 


7F31 


C37D04 


0043 
00440 


30AWAY 


JP 


047DH 


OUT TO DRIVER NOW 






00450 


ltitlttltttttt*t§tttttttHtttltHtttttttfttttttittttttt 






00460 


PUT VIDEO PATCH INTO PLACE UP0^ 


t LOAD 






00470 


teta 


tfttiit 


#*#####««###«## 


?#«#«#«««#######«## 






00480 










4Q1E 




004S0 




ORG 


401 EH 


THIS IS VIDEO PATCH 


401 E 


007F 


00500 
00510 




DEFW 


LCDRIV 


PUT LCDRIV ROUTINE IN 






00520 


####« 


tttttttttttHt*tttHlittt 


»##########»###*#*#*##*## 


06CC 




0053 




END 


OECCH 


BACK TO BASIC READY 


00000 TOTAL 


EBRORS 











Listing 3-13. Upper/lower case driver. 



Using The Editor/Assembler 

The Editor/Assembler is one of the most 
powerful tools available to the TRS-80 
customizer. It is a fast, high-level compiler 
which produces a block of Z-80 machine code. 
Its job is to provide an easily accessible 
substitute for the tedious creation of bytes of 
Z-80 coded information. 

The Z-80 microprocessor is capable of 
responding to many hundreds of combinations 
of ones and zeros. Each pattern causes the 
Z-80 to follow a unique pattern of electronic 
activity, and many thousands of those activities 
in concert create a sophisticated language like 
BASIC. 

Using these patterns can be very tricky and 
time-consuming. Long ago, computer designers 
learned that it was easier to remember an 
action like 'load the accumulator with the 
contents of byte counter register' as 'Load A 
with B', abbreviated LD A,B. This is much 
handier than trying to recall 01111000. These 
abbreviations are called mnemonics, which are 
what you will find in all the program listings in 
this book. 

You will also find that, instead of specific 
locations in memory (such as 3C00), there may 



from the convert-to-upper-case display function 
in ROM. Ideally, this ROM routine could just be 
entered after its convert-to-upper case code; 
unfortunately, this would result in the famous 
inverted display . . . normal upper case, shifted 
lower case. 

To avoid this, the character is tested and 
converted to its proper case before being 
returned to the ongoing display driver routine in 
ROM. Notice something interesting: when 
programs are listed with this driver, the letters 
appear in lower case. That is because when the 
programs are entered, they are in fact being 
entered with the keyboard unshifted. Because 
this can be a bit disconcerting (and also quite 
illegible, since we all are used to upper case lists), 
an upper case on/off software patch is provided. 



be a 'label' (such as VIDEO). Once VIDEO has 
been defined as 3C00 to the Editor/Assembler, 
it will always interpret the label as the number 
that was assigned to that label. 

Line numbers are provided to keep things in 
order and to insert or edit pieces of code, and 
there is space on every line for comments. 

Load the Editor/Assembler tape under the 
SYSTEM command. Its name is EDTASM. 
When the loading is complete, enter a slash (/), 
and you will be presented with the prompt: 

TRS-80 EDITOR/ASSEMBLER 1 .1 

This is EDTASM's equivalent of the BASIC 
prompt: 

RADIO SHACK LEVEL II BASIC 

READY 

>_ 

You are being asked for input. Unlike 
BASIC, EDTASM has only a few commands. 
They are (in the order you are likely to use 
them): 



This command inserts numbered program 
lines almost exactly like the BASIC command 
AUTO. When I is entered alone, numbering 
starts with line 100 in increments of 10 line 
numbers. On the other hand, 115,15 will start 
with line 15 in increments of 15. 
P 

The equivalent of a list. A single P lists the 
next sixteen lines of the program. P10:100 
lists 10 to 100. P# is the first line, P. is the 
current line, and P* is the last line. 

N 

Here is the renumber command. All lines are 
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automatically renumbered in increments of 10 
starting with line 100. Again, specific lines 
and increments may be specified: N300.50 
will renumber all lines in increments of 50, 
with the first line being 300. 

L 

Loads a source tape, but not an object tape. 

Up to a six-character name may be specified. 

W 

Writes a source tape (the program listing). Up 

to a six-character name may be specified. 

D 

Deletes the specified line or lines. D# deletes 

the first line, D. deletes the current line, and 

D* deletes the last line. Groups of lines are 

specified with a colon, as D40:170 or D#:90. 

E 

The edit function. The pound (#), period (.), 

and asterisk (*) represent the first, current, 

and last lines. A line number (as E400) may be 

specified.The editing functions are identical 

to BASIC'S editing functions - except that 

characters to be deleted are not deliniated by 

exclamation points. 

R 

Replaces the indicated line. The line number 

is presented, and new information may be 

entered. 

F 

This command finds a text string. It is not 
followed by a space. To search for the phrase 
'ENTRY', type FENTRY (ENTER). The 
entire line containing the phrase will be 
printed. To find the next identical phrase, 
merely type F (ENTER). 

H 

This sends the source listing, unassembled, to 
the printer. The complete source listing, 
including line numbers, is printed. As usual, 
(#), (.) and (*) may be used to indicate first, 
current, and last line, and groups of lines may 
be printed (as H55:3000). 

T 

The poor person's text editor. The source code 
is sent to the printer without line numbers. 
Thus, text may be entered a line at a time, and 
the numberless result printed. The same 
functions provided with H are available. 

B 

The exit to BASIC. As sold, EDTASM returns 
only to MEMORY SIZE?, and all programs 
and information, including EDTASM itself, 
are lost. Patches are available to re-route this 
exit. 



This command directs EDTASM to compile 
your source code into object code, make a list 
of all the labels (symbols) used, and check for 
errors. The A command may be followed by a 
six-letter name, as well as the 'switches' /NL 
(no listing), /NS (no symbol table), /NO (no 
object code), or /WE (wait upon error). The 
switches may be used in any combination, and 
are useful in shaking the errors out of an 
assembly program. 

Lines are always entered into EDTASM 
under the I (insert) or R (replace) commands. 
A line number is presented, so: 

0D010*_ 

Several columns are then available, 
consisting respectively of an optional label, the 
mnemonic instruction, the 'operand' (if any), 
and any comments (always following a 
semicolon). A complete group of lines would 
look like this: 



00010 VIDEO EQJJ 3C00H 

00020 ORG 5000H 

00030 ENTRY LD A,B 

00040 LD HL .VIDEO 



iSCHEEN TOP 
;START PR0GRM 
;BET B INTO A 
;HL AT SCREEN 



This excerpt gives this information: the label 
VIDEO is an 'equate' (is defined as) location 
3C00. The program starts (has its origin - 
ORG) at 5000. The label ENTRY is assigned 
to the start of the program, and that program's 
first action is to load the accumulator with 
register B. Next, the HL register is pointed to 
VIDEO (3C00), the start of the screen memory. 

When told to assemble this (using the A 
command), the results will look like the 
following: 



3C0O 


0001 


VIDEO 


EOU 


3C00H 


[SCREEN TOP 


5000 


00020 




ORG 


5000H 


; START PR0GRH 


5000 78 


00030 


ENTRY 


LD 


A,B 


;GET B INTO A 


5001 21003C 


00040 




LD 


HL.VIDE0 


;HL AT SCREEN 



The EDTASM program evaluated all the 
information in the source code and created the 
columns at the left. The first column specifies 
the current address, and the second column 
specifies the machine language code, if any, for 
that particular line. Note the correct 
assignment of 3C00 to VIDEO in line 00040. 78 
is the machine code for LD A,B and 21 is the 
machine code for LD HL,NNNN. In this case, 
NNNN is VIDEO is 3C00. 

For detailed instructions, refer to the 
EDTASM instruction manual. One thing to 
note: you can conserve source code memory 
space by using the right arrow (tab) instead of 
spacing between program lines, labels, 
commands, operands, and comments. Each tab 
is a single character, but spaces are counted 
separately. 
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0000 E3 

0001 70 

0005 FE5B 
0004 S003 

0006 70 

0007 FE1D 
0009 E3 
OOOA C2781D 



OOOD CD781D 

0010 F5 - 

0011 FEDO 
0013 2805 

0015 F1 

0016 2B 

0017 C3781D 



001A F1 
001 B CD781D 
001 E 2003 
0020 C39719 



00 23 
0026 
0027 
0029 
002C 
002E 
0031 
0033 
0036 
003S 
003B 
003D 
0040 
0042 
0045 
0047 
004A 

004C 
004F 
0051 
0054 
0056 
0059 



117B1D 

05 

FEAO 

CAOOOO 

FEBB 

CAOOOO 

FEA2 

CAOOOO 

FECC 

CAOOOO 

FEC8 

CAOOOO 

FEEA 

CAOOOO 

FEA1 

CAOOOO 

FEAO 

CAOOOO 

FEA4 

CAOOOO 

FEA5 

CAOOOO 

C32000 



0000 

00010 TOTAL 



00100 

00110 

00120 

00130 

00140 

00150 

00160 

00170 

00180 

00190 

00200 

00210 

00220 

00230 

00240 

00250 

00260 

00270 

00280 

00290 

00300 

00310 

00320 

00330 

00340 

00350 

00360 

00370 

003B0 

00390 

00400 

00410 

00420 

0043 

00440 

00450 

00460 

0470 

00480 

00490 

00500 

00510 

00520 

00530 

00540 

00550 

00 56 

00570 

00580 

00590 

00600 

00610 

00820 

00630 

00640 

00650 

00660 

00670 

00680 

00690 

00700 

00710 

00720 

007 3 

007 40 

00750 

00760 

00770 

007 80 

007 90 
00800 
00810 
00820 
00B30 

008 40 
00B50 
00860 
00870 

OOBBO 

008 90 
00900 
00810 
00920 
00930 
00940 
00950 
00960 
00970 

009 80 
00990 
01000 
01010 
01020 
01030 

ERRORS 



tttt*tHU*t»tHtlUI*ttttltt**ltttttttttttt*ttlttttttt 

CUSTOM BASIC INTERPRETER PATCH FOR USE WITH ALL OF THE 
ROUTINES PRESENTED IN CUSTOM TRS-80 WHICH ARE TRANS- 
PARENT TO BASIC. THESE ROUTINES ARE'CALLED BY THIS 
ROUTINE. WHICH HAS ALREADY PLACED A RETURN VALUE ON THE 
STACK. ALL TRANSPARENT ROUTINES MUST EXECUTE A RETURN 
INSTRUCTION AS THEIR FINAL INSTRUCTION TO WORK WITH 
THIS CUSTOM INTERPRETER ROUTINE. THE COMMANDS AVAIL- 
ABLE WITH THIS INTERPETER ARE: 

/LOAD /SAVE /NEW /OPEN 

/ON /OFF /GET /PUT 

/STEP /MEM 
AND OTHER USER-DEFINED >•/•' COMMANDS AND ROUTINES. 
THIS ROUTINE HAS PUSHED THE RETURN ADDRESS S1D7B) ON 
THE STACK. THE ROUTINE JUMPED TO IS A PSEUDO-CALL 
IN THAT IT EXECUTES A "RET", THUS RETURNING TO 1D78. 
ttnttttttttttttH**ttHtttittt»ittt*t**********t****** 



EQ.U 



1D78H 



;ROM READ KEYS & TOKENIZE 



ttttttttHttttt*tt*ttti*i*t*tt*tt***tt***********t*M* 

CHECK THAT THE BASIC STACK IS IN INTERPRETATION MODE 

titttttttttttttt*itttnuttt»*t*ttttttttu»tiittttttt 



EX 
LD 
CP 
JR 
LD 
CP 
EX 
JP 



(SP) ,HL 

A.L 

5BH 

NZ.NOTRDY 

A.H 

1DH 

(SP! ,HL 

NZ.BYTE 



GET SP INTO HL FOR TEST 
GET L INTO A FOR TEST 
IS LSB OF STACK 5B7 
NOT INTERPRETING IF NZ 
GET H INTO A FOR TEST 
IS MSB OF STACK 1D7 
RESTORE STACK TO SP 
IF NOT 1DH THEN TO ROM 



tttitttt*tH**tlt**tt»*tt*lftt*t ############*########## 

MUST HAVE BEEN AT 1D5B FOR INTERPRETATION: THEREFORE, 
CHECK TO SEE IF SPECIAL SLASH (/) COMMAND THAT IS NEXT 

READ CHAR. & TOKENIZE 
SAVE VALUE READ 
IS IT "/" COMMAND? 
IF SO, THEN CONTINUE 
ELSE RESTORE AF VALUE 
PUT POINTER BACK ONE 
AND BACK TO NORMAL ROM 

; tltttttt*t**ttt*t*tHHItt**i*tt*******t********l****** 

; SLASH (/) HAS BEEN FOUND, THEREFORE MUST BE COMMAND 



CALL 


BYTE 


PUSH 


AF 


CP 


ODOH 


JR 


Z.OKSLSH 


POP 


AF 


DEC 


HL 


JP 


1D78H 



OKSLSH 



POP AF 

CALL BYTE 

JR NZ.SAVE 

JP 1987H 



RESTORE VALUE TO AF 
NEXT COMMAND IN LINE 
GO IF ONE IS IN PLACE 
?SN ERROR IF LINE END 



ttttttitttttttttttHHttltttt1tttHtt»tlttUttttt*tHH 

SINCE SLASH a NEXT CHARACTER HAS BEEN FOUND, NOW NEXT 
CHARACTER IN LINE MUST BE TESTED FOR VALIDITY AS USER- 
DEFINED COMMAND. SEE ABOVE FOR THOSE AVAILABLE HERE. 
tHHittttttttt*t*tHHt*itttt*ttHtttttt*it»ittHIHItt 

GET RETURN ADDRESS 
PLACE IT ON STACK 

SAVE 

GO TO SAVE ROUTINE 

NEW 

GO TO RENEW ROUTINE 

OPEN 

GO TO OPEN ROUTINE 

STEP 

GO TO STEPPING ROUTINE 

MEM 

GO TO MEMORY SET ROUT. 

LOC 

GO TO RELOCATION ROUT. 

ON 

GO TO DEBOUNCE ON ROUT. 

OUT 

KILL DEBOUNCE ROUTINE 

GET 

GO TO READ TAPE ROUTINE 

PUT 

GO TO WRITE TAPE ROUT. 
?SN ERROR IF UNDEFINED 

HHttttttttHtHt*Httttttl>ttHtttlttHttt*tttt*ttHtt 

THIS ROUTINE WILL NOT ASSEMBLE AS IT STANDS. IT MUST 
BE APPENDED TO THE OTHER ROUTINES WHICH WILL BE USED 
IN CONJUNCTION WITH BASIC. ALL THE TERMS LISTED ABOVE 
MUST BE DEFINED, OR ELSE THEY MUST BE DELETED FROM THE 
ASSEMBLY LISTING. 

ttt*ttttiiittiimtttniitfttttttttttfntttnttit*f§ttt 

END 



LD 


DE.1D78H 


PUSH 


DE 


CP 


OADH 


JP 


Z, SAVER 


CP 


OBBH 


JP 


Z, RENEW 


CP 


0A2H 


JP 


Z, OPENER 


CP 


OCCH 


JP 


Z.STPSET 


CP 


0C8H 


JP 


Z.MEMSET 


CP 


OEAH 


JP 


Z.RELOC 


CP 


0A1H 


JP 


Z.KEYON 


CP 


OAOH 


JP 


Z.KEYOFF 


CP 


0A4H 


JP 


Z.COPYIN 


CP 


0A5H 


JP 


Z.DUSBER 


JP 


SYNERR 



Patching the BASIC Interpreter 

Each time a BASIC command is entered or a 
program line is being run, a section of ROM 
evaluates each of these commands in order, 
jumping to internal subroutines that will 
produce the desired result. This section of ROM 
is called the interpreter, an area which translates 
the commands into program action. 

At address 4003, the machine language 
instruction C3 78 ID can be found, which means 
'jump to address 1D78'. 1D78 is the main entry 
point to the BASIC interpreter. But the routine 
can be intercepted before going to 1D78, by 
patching a different jump into addresses 4004 
and 4005. 

This intercept is very important, because pvery 
BASIC - transparent software modification in 
this book will be patched into this location, 
leading to the master custom interpreter 
program below (Listing 3-2). When a command 
line is entered, the program in Listing 3-2 
intercepts the routine at 4003, and first examines 
the status of the stack pointer; if it points to 
1D5B, then the intercept program knows BASIC 
is in the interpretation mode. 

Its next step is to CALL 1D78. By calling 1D78 
instead of jumping to it, a 'tokenized' version of 
the next command in line is returned to the 
master custom interpreter. Tokenizing is an 
important, specialized process which allows the 
BASIC listings to use very little memory and 
allows the interpreter to evaluate commands at 
high speed. 

When the token is returned to the custom 
interpreter, it can then be evaluated to see if it is 
a specially designated indicator command. 

If the slash command indicator is found by the 
custom interpreter, it moves on to a lookup table 
to search for one of the specialized commands. 
All these commands will be tokens as well, so only 
a single byte comparison need be made. 

There is another method of patching into the 
BASIC interpreter. If you are a Level II user, 
merely enter the command OPEN. Very 
promptly the computer will respond with '?L3 
ERROR'. What is an '?L3 ERROR'? It refers to 
a 'Level III Error', the extended BASIC that is 
available as a part of the TRS-80 disk system. 

Now enter the statement OPNE. This time a 
'?SN ERROR' is produced. How does the 
machine know that OPEN is a disk command 
and that OPNE is just garbage? 
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4093 
403D 
401A 
4019 



4016 

401 6 3930 

401 E 

401 E 2A31 



3039 



3039 213640 
303C 010138 
303F 1600 



3041 0A 

3042 5F 

3043 A3 

3044 2018 
3046 77 



3047 14 

3048 2C 

3049 CB01 
304B 79 



304C 0680 
304E 20F1 



3050 0607 

3052 2D 

3053 86 

3054 10FC 

3056 A7 

3057 3E00 

3058 CO 



305A 321A40 
3050 09 



305E A6 
3Q5F 281E 
3061 3ASS40 

3064 A7 

3065 20E0 
3067 3A1A40 
306A 3C 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
' 00220 
00230 
00240 
00250 
00260 
00270 
00280 
00280 
00300 
00310 
00320 
00330 
00340 
00350 
00360 
00370 
00380 
00390 
00400 
00410 
00420 
00430 
00440 
00450 
00460 
00470 
004B0 
00490 
00500 
00510 
00520 
00530 
00540 
00550 
00560 
00570 
00580 
00590 
00600 
00610 
00620 
00630 
00640 
00650 
00660 
00670 
00680 
00690 
00700 
00710 
00720 
00730 
00740 
00750 
00760 
00770 
00780 
00790 
00800 
00810 
00820 
00830 
00B4O 
00850 
00860 
00870 
008 BO 
00890 
00900 
00910 
00920 
00930 
00940 
00950 
00960 
00970 
00980 
00890 
01 000 
01010 
01020 
01030 
01040 



tttmmtttmttMHttttttmtttttttttttttttttttttttt 

FULL-FEATURED KEY/SCREEN DRIVER - DENNIS BATHORY KITSZ 
THIS ROUTINE IS A LEVEL II KEYBOARD REPLACEMENT ROUTINE 
CAPABLE OF PROVIDING: AUTOREPEAT AFTER SELECTED DELAY 
(FOUND IN B REGISTER IN DELAY SECTION); BEEP WITH ANY 
CHOICE OF PITCH; RESULTANT DEBOUNCE; CORRECTED SHIFT- 
DOWN ARROW CONTROL CODE FOR EARLIER LEVEL II ROMS; A 
SHIFT-0 SELECTABLE UPPER/LOWER CASE DRIVER AND DISPLAY. 
NOTE THAT THIS ROUTINE IS SET UP FOR USE AT 3039 HEX 
(12345 DECIMAL) FOR ENTRY IN THE MEMORY SIDECAR WHICH 
IS ADDRESSED FROM 3000 TO 37D0 HEX. IT MAY BE SET TO 
ANY ORIGIN OF THE USER'S CHOICE, SUCH AS USUAL HIGH MEM 

*t*ttt*t*tttt»tttttttttttt**ttt*tttttttttttttttttttntt 

INKEYS EOU 4099H ;INKEYS BYTE STORAGE AREA 

PORTFF EOU 403DH [CASSETTE OUTPUT PORT 

KPLACE EQU 401AH ;1-BYTE KEYSTROKE STORE 

SHIFTR EQ1I 401 9H [STORAGE FOR LC DRIVER 

tttstmtmmtmmmttmmstmwmtmttmtts 

PATCH KEYBOARD ROUTINE INTO 4016 AND DISPLAY INTO 401 E 

*tttt*t*ttttt**tnttnttt*tnttttti*ttMtttttttttttttt 



START OF KEYBOARD SCAN 
PATCH KEYBOARD ROUTINE 
START OF DISPLAY SWEEP 
PATCH UPPR/LOWR ROUTINE 

START AT MEMORY SIDECAR 



ORG 


401 6H 


DEFW 


KBPFIX 


ORG 


401 EH 


DEFW 


LOWER 



ORG 



3039H 



f#####f#######f###f#f#*################f######f ######## 

SET STORAGE #1 , ROW #1 , COUNTER #0 PARAMETERS FOR SCAN 
f##f#####f#######ff#f###f#######f######f######ff ####### 

KBPFIX LD HL.4036H ; STORAGE FOR KEYSTROKE 
LD BC.3801H ; FIRST ROW OF KEYS 
LD D,0 ; COUNTER FOR CDLUMS 

WtttititiHttttttttttttttttttttitttttttttttttftttttttt 

CHECK EACH ROW OF KEYS IN SEARCH OF ONE THAT IS PRESSED 

mtttttttmttttHHtttnttt»tt*n*t*tttt*titt*t*nt*t 



RETRIEVE ROW CONTENTS 
SAVE IT TEMPORARILY 
SET FLAGS FOR TEST 
NOT ZERO IF KEY PRESSED 
SAVE CURRENT VALUE 



mt*tmtlti»i»ttitttt*ttttttttiii§tt§Httit§ttttttt*t 

INCREMENT AND ROTATE PATTERN CHECKS EACH ROW IN TURN 

Mtmtmmttittmtmmmmtmmtmttmmm 

RECHEK INC ; INCREMENT ROW COUNTER 

INCREMENT STORAGE AREA 
GET NEXT KEYBRD COLUMN 
GET VALUE INTO ACCUM. 

ttmmmmtttmtmmmmtttmettttmmttm 

CHECK IF LAST VALID ROW (I.E., NOT INCLUDING SHIFT KEY) 

mtmMmmmmmmtummmtmmmtmm 



LD 


A,(BC) 


LD 


E,A 


AND 


E 


JR 


NZ, STROKE 


LD 


(HL).A 



INC 





INC 


L 


RLC 


C 


LD 


A,C 



SUB 
JR 



BOH 
NZ.KEYPRS 



LAST ROW IS 38B0 HEX 
NEXT CHECK IF NOT DONE 



ttt»ttttttMttttti*tttttiitttttttntttttttt*ttttt»ttttt 

AUTOREPEAT STATUS TEST ... CHECK IF KEYBOARD IS CLEAR 

**t*tt*t*t*tttnt*tttttt*tttttt**t*t*t**ttttttttt*t**tt 



COUNTER OF KBRD ROWS 
START COUNTING BACK 
AND ADD IT UP IN ACCUM 
AND DO IT FOR 7 ROWS 
TEST FOR ANY KEY DOWN 
A=0, FUGS ARE INTACT 
BACK IF KEYS IN USE 



ttntmmmm»ttmtfmtmmtmmm*mt*fstt 

RESET AUTOREPEAT DELAY TO ZERO IF THE KEYBOARD IS CLEAR 
it*tttttttttt*t§t*tHtttttt*t*t*ittttttititmttt*ttttt 



LD 


B,7 


DEC 


L 


ADD 


A,(HL) 


DJNZ 


CLRMEM 


AND 


A 


LD 


A,0 


RET 


NZ 



LD 
RET 



(KPLACE) ,A 



ELSE DELAY GETS RESET 
AND GO BACK ANYWAY 



*tm**t*tttt*mmtttmttttttttttmttttttttttmtit 

IF KEYSTROKE IS FOUND, CHECK STATUS OF AUTOREPEAT LOOP 

nttmmtmMtttmmmttmtmmtmmmmm 



CHECK KEYSTROKE STORAGE 
NEW KEY IF NOT SAME 
CHECK STATUS OF INKEY$ 
TEST IF SOMETHING THERE 



AND 


(HL) 


JR 


Z, FOUND 


LD 


A, (INKEYS) 


AND 


A 


JR 


NZ, RECHEK 


LD 


A.IKPLACEJ 


INC 


A 



IF THERE IS, LOOP BACK 
NOW CHECK SPECIAL STORE 
LET STORE = STORE + 1 

Listing Continued , , , 



It is in this distinction that the other patch can 
be made into the BASIC interpreter. All the 
DOS (disk operating system) commands already 
exist in Level II BASIC! A patch point 
(sometimes called a 'vector', other times a 'hook') 
is provided for each of these commands in RAM. 
When the disk system is added to the TRS-80, 
each of these patch points is filled with a jump to 
a DOS parameter. 

Table 3-(?) presents a list of the DOS 
commands and their patch points in RAM. If you 
are not (and do not plan to be) a disk user, and if 
your programs will not be sold to potential disk 
users, then these patch points are for you. Each 
one can be used for your own set of commands, 
and every one will be accepted by a running 
BASIC program. 

List of DOS Patch Points 



DOS 


REPLACEMENT 


REPLACEMENT 


COMMAND 


PATCH POINTS (HEX) 


PATCH POINTS (DECIMAL) 


CVI 


4153 


- 4154 


10723 


- 16724 


FN 


4156 


- 4157 


16726 


- 16727 


CVS 


4159 


- 41 5A 


16729 


- 16730 


DEF 


41 5C 


- 41 5D 


16732 


- 16733 


CVD 


41 5F 


- 4160 


16735 


- 16736 


EOF 


4162 


- 4163 


16738 


- 16739 


LOC 


4165 


- 4166 


16741 


- 16742 


LOF 


4168 


- 4169 


16744 


- 16745 


MKIS 


41 6B 


- 41 6C 


16747 


- 16748 


MKSS 


41 6E 


- 41 6F 


16750 


- 16751 


MKD$ 


4171 


- 4172 


16753 


- 16754 


CMD 


4174 


- 4175 


16756 


- 16757 


TIMES 


4177 


- 4178 


16759 


- 16760 


OPEN 


41 7A 


- 417B 


16762 


- 16763 


FIELD 


4170 


- 41 7E 


16765 


- 16766 


GET 


4180 


- 4181 


16768 


- 16769 


PUT 


4183 


- 4184 


16771 


- 16772 


CLOSE 


4186 


- 4187 


16774 


- 16775 


LOAD 


4189 


- 41 8A 


16777 


- 16778 


MERGE 


41 8C 


- 41 BD 


16780 


- 16781 


NAME 


41 BF 


- 4190 


16783 


- 167B4 


KILL 


4182 


- 4183 


16786 


- 16787 


a 


4195 


- 4186 


16789 


- 16790 


LSET 


4198 


- 4198 


16792 


- 16793 


RSET 


41 9B 


- 41 9C 


16795 


- 16786 


INSTR 


41 8E 


- 41 9F 


16798 


- 1678) 


SAVE 


41 A1 


- 41 A2 


168Q1 


- 16802 


LINE 


41 A4 


- 41 A5 


16804 


- 16905 



Creating BASIC Tokens 
Here's a program to start this discussion: 

10 CLS : REM XXXXXXXXXXXXX 

20 Y = 15360 

30 FOR X = 17129 TO 17300 

40 POKE Y, PEEK (X) 

50 Y = Y + 1 : NEXT X 

60 PRINT "END OF PROGRAM" 

70 PRINT "LIST OF PROGRAM" 

BO LIST ; REM ZZZZZZZZZZZZ 

On the screen you now have two versions of 
the identical information - the BASIC 
program. The lines of X's and Z's are there to 
help you locate the program amidst some of 
what looks like garbage. You will also see that 
there are some familiar elements missing: the 
line numbers (which have been converted to 
hexadecimal), and all the BASIC commands 



The Custom TRS-80 
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Creating BASIC Tokens 



Continued Listing 



306B 
306E 
307D 
3072 
3073 
3075 
3077 
3078 
307A 
307 B 



321 A40 

FEFF 

2808 

C5 

Q6FF 

10FE 

C1 

1BCD 

3D 

321 A40 



307E 7B 
307 F 73 
30B0 7A 
3081 07 
30BS 07 
3083 07 
30B4 57 



3085 0E01 

3087 79 

3088 A3 
3QB9 2005 
308B 14 
30BC CB01 
308E 18F7 



3090 3AB038 
3093 47 
3084 7A 
3095 CB4Q 
3097 FE60 
3099 3016 
3Q8B 57 



309C 3A403B 
309F E610 
30A1 2009 
30A3 7A 
30A4 CBOB 
30A6 3830 



30AB 

30AA 

30AC 

30AD 

30AF 

30B1 

3QB3 

30B5 

30B7 

30B9 

30BB 

30BD 

30BF 

30C1 

30C3 

30C5 

30C6 

30CB 

30CA 

30CB 

30CE 

30CF 

30D1 

30D2 

3003 



C620 

1839 

7A " 

0640 

1B34 

0670 

3010 

0640 

FE3C 

3802 

EE10 

CBOB 

3024 

EE10 

1B20 

07 

CB08 

3001 

3C 

21D530 

4F 

0600 

09 

7E 

1810 



01050 

01060 

01070 

01080 

01090 

01100 

01110 

01120 

01130 

01140 

01150 

01160 

01170 

011 BO 

01190 

01200 

01210 

01220 

01230 

01240 

01250 

01260 

01270 

01280 

01290 

01300 

01310 

01320 

01330 

01340 

01350 

01360 

01370 

01380 

01390 

01400 

01410 

01420 

01430 

01440 

01450 

01460 

01470 

01480 

01490 

01 SOD 

01510 

01520 

01530 

01540 

01550 

01560 

01570 

015B0 

01590 

01600 

01610 

01620 

01630 

01640 

01650 

01660 

01670 

01 6 BO 
01690 
01700 
01710 
01720 
01730 
01740 
01750 
01760 
01770 

01 7 BO 
01790 
01 BOO 
01810 
01820 
01830 
01840 
01850 
01860 
01870 
01880 
01890 
01900 
01910 
01920 
01930 
01940 
01950 
01960 
01970 
01980 
01990 



TMWSTE 



DECA 



LD 

CP 

JR 

PUSH 

LD 

DJNZ 

POP 

JR 

DEC 

LO 



[KPLACEJ.A 

OFFH 

Z.DECA 

BC 

B.OFFH 

TMWSTE 

BC 

BECHEK 

A 

IKPLACEJ.A 



AND PUT IT BACK THEHE 
CHECK IF IT IS AT END 
IF SO, THEN HOLD THERE 
SAVE ROW COUNTER REG. 
GET DELAY VALUE INTO B 
AND DELAY JUST A BIT 
AND RESTORE ROW COUNTER 
AND BACK TO CHECK NEXT 
LET A = A - 1 (STORAGE] 
AND PUT IT IN STORAGE 



get keyboard byte back, store and prepare to manipulate 
#####«######m*##mmm#m######m#«#m##m########## 

first convert d from counter to pseudo ascii equivalent 



FOUND 



LD 

LD 

LD 

RLCA 

RLCA 

RLCA 

LD 



A,E 

[HL),E 

A,D 



D,A 



GET KEYBOARD BYTE BACK 
STORE IT IN STROKE AREA 
GET ROW COUNTER FROM 
AND BEGIN A PROCESS... 

...OF CONVERTING IT... 
...TO AN OFFSET VALUE. 
AND PUT IT BACK IN D 



• NOW PREPARE ROW COUNTER C TO COMPLETE ASCII CONVERSION 



BACKUP 



LD 

LD 

AND 

JR 

INC 

RLC 

JR 



C,1 

A,C 

E 

NZ, AROUND 

D 

C 

BACKUP 



GET NUMBER ONE READY 
ACCUM. HAS C FOR MATH 
TEST IF C = KEYSTROKE 
IF NOT, THEN GO AROUND 
ELSE = ROW + COLUMN 
C SET TO NEXT COLUMN 
GO BACK AND TEST AGAIN 



Mtmmmtmttmmmmttmmmmmttmtitt 

SHIFT ROW IS TESTED TO DETERMINE UPPER/LOWER STATUS 



AROUND 



LD 

LD 

LD 

ADD 

CP 

JR 

LD 



A,(3BB0H) 

B,A 

A,D 

A.40H 

BOH 

NC.Z0429H 

D,A 



GET SHIFT ROW FOR TEST 
AND SAVE IT IN B 
GET ROW COUNTER BACK 
AND CONVERT TO ASCII 
IS IT UP/LW/GRAFIX/ETC 
GO OUT IF GRAPHICS MODE 
SAVE PARTLY CONVERTED 



Mmtt»mtmnttmmmtHmitttttMttttm*mt 

SHIFT/DOWN ARROW CHECKED FOR CONVERSION TO CONTROL CODE 

mmmmmmmmmtittmttmtmmstmmst 



LD 

AND 

JR 

LD 

RRC 

JR 



A.13840H) 

10H 

NZ.CNTROL 

A,D 

B 

C.GOAWAY 



GET VALUE FOUND 7TH ROW 
CHECK IF DOWN ARROW 
IF SO, PRODUCE CONTROL 
ELSE GET VALUE BACK 
B BUMPS INTO CARRY FLAG 
IF CARRY, THEN SHIFT 



mtmttmtttttttttttttttmttntttmttMittti***** 

LOWER CASE CONVERSION, MASK STRIPPING, FINAL TOUCHES 

nMtnttimMm«tmmntmmmmemmmmt 



ADD 
JR 
CNTROL LD 
SUB 
JR 
Z0429H SUB 
JR 
ADD 
CP 
JR 
XOR 
Z0435H RRC 
JR 
XOR 
JR 
Z043DH RLCA 
RRC 
JR 
INC 
Z0443H LD 
LO 
LD 
ADD 
LD 
JR 



A.20H 

GOAWAY 

A,D 

40H 

GOAWAY 

70H 

NC,Z043DH 

A.40H 

3CH 

C.Z0435H 

10H 

B 

NC, GOAWAY 

10H 

GOAWAY 



NC.Z0443H 

A 

HL, TABLET 

C,A 

B,0 

HL.BC 

A.tHL) 

GOAWAY 



IF NOT THEN LOWER CASE 
AND GET OUT OF ROUTINE 
IF CONTROL CODE, GET IT 
GET RID OF ASCII MASK 
AND GET OUT OF ROUTINE 
THE BALANCE OF THE 

ROUTINE BELOW UP TO 
THE BEEP SECTION IS 
VIRTUALLY IDENTICAL 
TO THE KEYBOARD 
DETERMINATION SUB- 
ROUTINE FOUND IN 
ROM. A COMPLETE 
DESCRIPTION OF THIS 
SECTION OF THE KEY- 
BOARD SCAN IS FOUND 
IN THE CHAPTER 
SUPPLEMENT ON THE 
ROM KEYBOARD SCAN. 
THIS TABLE IS CHANGED 
FROM THE ONE FOUND 
IN EARLIER ROMS, BUT 
THE ROUTINE USED TO 
ACCESS IT IS THE 
SAME. 



umtitmtttttttmmmmmmmmttttmmm 

TABLE BaOW DETERMINES TRS-BO [NOT ASCII! CONTROL CODES 
SEE SUPPLEMENT ON KEYBOARD SCAN FOR DETAILS ON CODES 

tttmttMmmtmtttmmnmtimtmtimumttm 

Listing Continued . , 



(CLS, FOR, TO, POKE, PEEK, NEXT, 
PRINT, and LIST). What has happened to 
them? 

For two purposes - economy of memory and 
speed of execution - legitimate BASIC 
commands are converted to single-byte keys 
called 'tokens'. When you enter a BASIC * 
command line, a subroutine evaluates each 
character group in that line, searching through 
all the keywords in ROM until it finds a match. 
When it finds a match, it replaces the original 
group of characters (PRINT, for example, 
which is five characters) with a single byte (178 
in this case). Four bytes are saved, and the 
lengthy process of looking up the word PRINT 
is eliminated at run time. 

Evaluating for tokens is indeed a 
time-consuming process. If you type 255 
characters of garbage and press (ENTER), the 
computer will spend nearly two seconds 
attempting to tokenize that line before 
reporting a ?SN ERROR. A line which uses 
the command CHR$() very often also takes 
time to tokenize. You can imagine the speed 
difference if this process were left to be done at 
RUN time. 

The presence of tokens in a complicated 
program can make the difference between a 
running program and an ?OM ERROR. As an 
experiment, return to MEMORY SIZE? and 
respond with 17250. This gives you about 50 
bytes of program space (at least 83 are needed 
to run any program). Enter these lines: 

10 PRINT"THIS IS A TEST TO FIND OUT" 

20 PRINT'TOW MUCH MEMORY SPACE IS IN HERE" 

In attempting to run this program, you will 
get an ?OM ERROR. Now remove the word 
'IN' and one space from the second line. The 
program will run fine. Finally, insert PRINT: 
on line 10. In spite of the fact that it looks like 
you have inserted 6 new characters 
(P-R-I-N-T-:), you have really only inserted 
two - the PRINT token (178) and a colon. 

There is a lesson in this. If your program is 
running quite close to the end of your system's 
available memory, try cutting down the lines of 
text within the program. Many more BASIC 
commands will then open up for use. 

Another interesting trick opens up. You may 
have a BASIC program which you would like to 
convert for use on a printer. This can take up 
quite a bit of time. As a quick fix, you might 
just leaf through your program, replacing all 
PRINTS with LPRINTs. This won't work 
every time (I'll explain later), but it's a useful 
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Chapter 3 



Creating BASIC Tokens 



Continued Listing 

3005 ODDD 
30D7 1F1F 
3DD9 0101 
30DB SB1B 
3000 0A00 
30DF 081 8 
30E1 0919 
30E3 2020 



02000 TABLET DEFW 

02010 DEFW 

02020 DEFW 

02030 DEFW 

02040 DEFW 

02050 DEFW 

02060 DEFW 

02070 DEFW 



30E5 
30E6 
30E8 
30EB 
30ED 
30F0 
30F2 
30F4 
30F7 
30F9 
30FC 
30FF 
3102 



57 

3A103B 

FE01 

2016 

3AB030 

FE01 

20 OF 

3A1940 

EE01 

321940 

010005 

CD6000 

C9 



3103 018001 
3106 CD6000 

3109 7A 
31 OA C5 
310B F5 
310C 0640 
310E 3A3D40 
3111 E6FD 

3113 67 

3114 F602 

3116 6F 

3117 7D 

3118 D3FF 
311A 7C 
31 1B D3FF 

3110 C5 
311E 0640 
3120 10FE 

3122 C1 

3123 10F2 

3125 F1 

3126 C1 

3127 C35204 
/ 



31 2A 
31 2B 
31 2E 
3130 
3132 
3133 
3136 
3137 
313A 
313D 
3140 
3143 
3144 
3148 
3147 
3148 
314A 
31 4D 
314F 
3152 



F5 

3A1940 

FE01 

2804 

F1 

C35B04 

F1 

DD6E03 

006604 

DASA04 

0D7E05 

B7 

2801 

77 

79 

FE20 

DA0605 

FEBO 

D2A604 

C37D04 



020B0 

02090 

02100 

02110 

02120 

02130 GOAWAY 

02140 BEEEEP 

02150 

02160 

02170 

02180 

02190 

02200 

02210 

02220 

02230 

02240 

02250 

02260 

02270 

02280 

02290 

02300 

02310 BLEEEP 

02320 



ODODH 
1F1FH 
0101H 
1B5BH 
OOOAH 
180BH 
1B08K 
2020H 



CARR. BET. / CARR. RET. 
CLEAR SCRN / CLEAR SCRN 
BREAK KEY / BREAK KEY 
EDIT ESCAPE / UP ARROW 
NOP (CHANGE) / LINEFEED 
BACKSP. LINE / BACKSP. 
32-CKAR MODE / HOR. TAB 
SPACE / SPACE 



*i***tt*tt**mttmtifttHHtnmmitititttimtmt 

"^L™!.*?.^™.™ Di STA ™ S 0f= SHIFT-0 TESTED 



LD 

LD 

CP 

JR 

LD 

CP 

JR 

LD 

XOR 

LD 

LD 

CALL 

RET 



D,A 

A, (381 OH] 

1 

NZ, BLEEEP 

A,(3BB0H) 

1 

NZ, BLEEEP 

A.(SHIFTR) 

1 

[SHIFTR),A 

BC,5D0H 

0060H 



SAVE VALUE IN REG. 
GET KEYBOARD ROW 
SEE IF IT IS ZERO (0) 
GO OUT IF NOT ZERO 
IF 0, CHECK SHIFT ROW 
CHECK IF SHIFT KEY 
IF NOT GO OUT TO BEEP 
ELSE GET SHIFTLOCK 
AND SWITCH 1-0 OR 0-1 
AND PUT IN SHIFTLOCK 
GET LONGER DELAY 
CALL ROM DELAY SUBR. 
AND GO BACK, NO BEEP 



DEBOUNCE IS ADDED 



ALTERNATE: BEEP HAY BE LENGTHENED 



06CC 

00000 TOTAL 

24295 TEXT 



02330 

02340 

02350 

02360 

02370 

02380 

02390 

02400 

02410 

02420 BEEPER 

02430 

02440 

02450 

02460 

02470 

02480 FREQCY 

02490 

02500 

02510 

02520 

02530 

02540 

02550 

02560 

02570 

02580 

02580 LOWER 

02600 

02610 

02620 

02630 

02640 

02650 L0WER1 

02660 

02670 

02680 

02690 

02700 

02710 

02720 

02730 GETCHR 

02740 

02750 
02760 
02770 
02780 
02790 
02800 
02B10 
ERRORS 
AREA BYTES LEFT 



LD 

CALL 

LD 

PUSH 

PUSH 

LD 

LD 

AND 

LD 

OR 

LD 

LD 

OUT 

LD 

OUT 

PUSH 

LD 

DJNZ 

POP 

DJNZ 

POP 

POP 

JP 



BC,1B0H 

0060H 

A,D 

BC 

AF 

B.40H 

A,[PQRTFFl 

OFDH 

H,A 

2 

L,A 

A,L 

(OFFH) ,A 

A,H 

(OFFH) ,A 

BC 

B.40H 

FREQCY 

BC 

BEEPER 

AF 

BC 

045 2H 



DEBOUNCE VALUE AND 

DELAY CALL TO ROM 
GET STORED VALUE BACK 
SAVE BC REGISTER 
SAVE ACCUH AND FLAGS 
GET NOTE LENGTH VALUE 
GET STATUS OF SCREEN 

MASK SCREEN CHANGE OUT 
STORE MSB IN H REG. 
SET BIT 1 TO BE ON 
STORE ALT. MSB IN L REG 
GET ALT. MSB TO OUTPUT 
AND OUTPUT RISING WAVE 
NOW GET NORMAL MSB 
ANO OUTPUT FALLING WAVE 
SAVE NOTE LENGTH REG. 
GET FREQUENCY DELAY 
AND WAIT A LITTLE WHILE 
NOW RESTORE LENGTH VAL. 
AND GO BACK THAT LENGTH 
RESTORE ORIGINAL CHAR. 
AND RESTORE ORIGINAL BC 
BACK TO ROM IN PROGRESS 



THIS IS LOWER CASE DETERMINATION FROM STORED INFO 



PUSH 

LD 

CP 

JR 

POP 

JP 

POP 

LD 

LD 

JP 

LD 

OR 

JR 

LD 

LD 

CP 

JP 

CP 

JP 

JP 



AF 

A.tSHIFTR] 

1 

Z.L0WER1 

AF 

0458H 

AF 

L,(IX+3) 

H,(IX+4J 

C.049AH 

A,(IX+5J 

A 

Z, GETCHR 

(HLJ.A 

A,C 

20H 

C.0506H 

BOH 

NC.04A6H 

047DH 



SAVE NEEDED REGISTER 
GET STATUS OF SHIFTLOCK 
CHECK IF STATUS = 1 
IF SO THEN GO TO L.C. 
ELSE GET ORIGINAL VALUE 
LEAVE TO NORMAL DISPLAY 
ELSE GET ORIGINAL VALUE 
GET CURSOR LSB INTO L 
GET CURSOR MSB INTO H 
BACK TO ROM IF CARRY 
GET CURSOR CHARACTER 
TEST IF CURSOR IS ON 
IF NOT THEN GO DO IT 
ELSE PUT IT BACK 
GET VALUE TO DISPLAY 
IS IT A SPACE OR CNTRL? 
OUT IF SPACE OR CONTROL 
IS IT GRAPHICS OR TAB? 
OUT IF GRAPHICS OR TAB 
DO UNCONVERTED DISPLAY 



MttHtttttmttmtMtttmttimttwitttifttmimt 

END 06CCH ; BACK TO BASIC READY 



AROUND 

BACKUP 

BEEEEP 

BEEPER 

BLEEEP 

CLRMEM 

CNTROL 

DECA 

FOUND 

FREQCY 

GETCHR 



3090 
3087 
30E6 
3117 
3103 
3052 
30AC 
3 07 A 
307F 
3120 
3147 



01460 
01350 
02140 
02420 
02310 
OOBOO 
01710 
01130 
01230 
02480 
02730 



01370 
01400 

02500 

02160 02190 

00820 

01600 

01070 

00390 

02480 

02710 



Listing Continued , 



crude first pass; enter this line from command 
level (no line number): 

FOR X=17130 TO 32767 : IF PEEK(XJ=178 THEN POKE X.175 : NEXl 

This line will search through all of memory 
(in a 16K machine), looking for the PRINT 
token (via PEEK), and replacing it wherever it 
finds it with the LPRINT token (via POKE). 

There are occasional risks with this kind of 
POKEing. Occasionally, a line number or part 
of the BASIC line organization addresses may 
have the same value as the PRINT token and 
get changed with this process. You might end 
up with a line like 37549 in the middle of a 
nicely ordered sequence of 1000, 1010, 1020, 
etc. Another possible flaw is that the value 
stored as a pointer to the next BASIC line may 
also correspond to the PRINT token, and get 
changed. You may get into a LIST-loop or 
'lose' some lines (at least to the eye - they are 
still in there). 

If a line number is wrong, merely delete the 
incorrect line number and retype a new line 
with the correct number. If some lines seem 
lost or the LIST command keeps looping, then 
temporarily reverse the process . . . 

FOR X=17130 TO 32767 : IF PEEK(XJ=175 THEN POKE X.178 : NEXT 

. . . and add a few REM statements in a line 
before the error occurred. Adding statements 
will alter the position of program lines in 
memory, and you will probably be able to 
perform the original conversion again safely. 

As you can see, the tokenizing process has a 
lot of distinct advantages. As a postscript, 
consider the program that opened this section. 
The tokens were displayed as graphics 
characters. Why is this so? 

Since there are only 256 possible 
combinations of bits in a byte, many times they 
have to serve multiple masters. In a machine 
language program, these bytes can be 
instructions. In a BASIC program, they are 
tokenized commands. On screen - which 
means in video memory - they appear as 
graphics. The 26 letters of our alphabet can be 
combined and recombined to form words, 
sentences, paragraphs, etc., and many words 
can sound alike or be spelled alike and still 
have different meanings; Context changes how 
words are understood. 

Douglas Hofstadter played on this most 
dramatically when he wrote, "This sentence no 
verb". 
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Continued Listing 



GOAWAY 30E5 02130 


01B30 


01700 01730 01B10 01830 01830 


INKEYS 40S9 00250 


01000 




KBPFIX 3039 00450 


00350 




KEYPHS 3041 00S30 


00730 




KPLACE 401A 00270 


00910 


01030 01050 01140 


LOWER 31 2A 02SB0 


00370 




L0WEH1 3136 026S0 


02620 




PORTFF 403D 00260 


02370 




RECHEK 3047 00B30 


01020 


01120 


SHIFTR 4019 002BO 


02200 


02220 02S00 


STROKE 30BE 00980 


00560 




TABLET 30D5 02000 


018B0 




TMWSTE 3075 01100 


01100 




Z042BH 30B1 01740 


01510 




Z0435H 30BD 01600 


01 780 




Z043DH 30C5 01840 


01750 




Z0443H 30CB 01880 


01B60 





4016 

4016 68 

4017 50 
5D68 

5D6B 211640 
5D6B 36E3 
5DBD 23 
5DBE 3603 
5D70 C38A46 



5D00 

5000 212140 

5D03 010138 

5D0B 1600 
5DDB OA 
5D08 5F 
500A A3 
5D0B 2019 
5D0D 77 
5DOE 14 
5D0F 2C 
5D10 CB01 
5D12 79 
5D13 D6B0 
5D15 20F1 
5D17 0607 
5D19 2D 
5D1A 86 
5D1B 10FC 
5D1D FEOO 
5D1F 3E0D 

5021 CO 

5022 321A40 
5025 C9 
5D26 A6 
5D27 2810 
5029 3A1A40 
5D2C 3C 
5D2D 321A40 
5D30 FEFF 
5032 200A 
5034 3D 
5D35 321A40 
5D3B 7B 
5039 73 
5D3A C5 
5D3B 010002 
5D3E CDBOOD 

5041 C1 

5042 OA 

5043 A3 
5D44 C8 
5D45 C5 
5D4B E5 

5047 F5 

5048 0640 
5D4A 3A3D40 
5D4D E6FD 
5D4F 67 
5D50 F602 



00100 

00110 

00120 

00130 

00140 

00150 

00160 

00170 

001 BO 

00190 

00200 

00210 

00220 

00230 

00240 

00250 

00260 

00270 

00280 

00280 ; 

00300 

00310 

0D320 

00330 

00340 LOOPX 

00350 

00360 

00370 

00380 

00390 REDOIT 

00400 

00410 

00420 

00430 

00440 

00450 

00460 LOOPY 

00470 

004B0 

00490 

00500 

00510 

00520 

00530 

00540 FOUND 

00550 

00560 

00570 

00580 

00590 

00600 

00610 

00620 

00630 

00640 SAME 

00650 

00660 

00670 

OOEBO 

00690 

00700 

00710 

00720 

00730 

00740 

00750 

00760 

00770 

00780 

007 9B 



####################################################### 

ADDING DEBOUNCE/BEEP/AUTOREPEAT TO EDITOR/ASSEMBLER 1 .1 

tmmmmmmsmmmtmmttttmmtttmm 

NEW EDTASM SCAN PATCH WILL USE ROM ROUTINE IN ITS PLACE 

tttut*tttHttttt*ttt***itt*itttt*ttttm**t*t*ttttmt 



ORG 

DEFB 

DEFB 

ORG 

LD 

LD 

INC 

LD 

JP 



4016H 

068H 

05DH 

5D6BH 

HL.4016H 

[HD ,0E3H 

HL 

{HU.03H 

46 BAH 



KEYBOARD PATCH POINT 
LSB OF NEW START 
MSB OF NEW START 
NEW PARTIAL KBD DRIVER 
FORMER KBD PATCH POINT 
LSB OF ADDRESS IN ROM 
GET NEXT POSITION READY 
MSB OF ADDRESS IN ROM 
JUMP TO EDTASM PROGRAM 



mtrntttttttttttttttttttttttititHttttttttttttttttiit 

NEW KEYBOARD SCAN IS PLACED AT FORMER SOURCE CODE START 

tttitmmmmtmttmnmtmmmmmmmmt 



ORG 

LD 

LD 

LD 

LD 

LD 

AND 

JR 

LD 

INC 

INC 

RLC 

LD 

SUB 

JR 

LD 

DEC 

ADD 

DJNZ 

CP 

LD 

RET 

LD 

RET 

AND 

JR 
LD 
INC 
LD 

CP 

JR 

DEC 

LD 

LD 

LD 

PUSH 

LD 

CALL 

POP 

LD 

AND 

RET 

PUSH 

PUSH 

PUSH 

LD 

LD 

AND 

LD 

OR 



5DD0H 

HL.4021H 

BC.38D1H 

D,0 

A,(BC) 

E,A 

E 

NZ, FOUND 

CHL) ,A 

D 

L 

C 

A,C 

80 H 

NZ, LOOPX 

B,7 

L 

A,(HL] 

LOOPY 



A,0 

NZ 

[401AHJ.A 

(HL) 

Z.SAME 

A,(401AH) 

A 

(401AH),A 

OFFH 

NZ, REDOIT 

A 

(401AH),A 

A,E 

(HL).E 

BC 

BC.Q200H 

0060H 

BC 

A.(BC) 

E 

Z 

BC 

HL 

AF 

B.40H 

A.1403DH) 

OFDH 

H,A 

02 



NEW BLOCK OF CODE 
GET REPEAT STORAGE BYTE 
GET FIRST ROW OF KEYBRD 
ROW COUNTER REGISTER 
FIND KEY PRESSED IN ROW 
SAVE VALUE IN E REG. 
TEST FOR PRESSED KEY 
JUMP OUT IF KEY PRESSED 
SAVE CURRENT KEY IN HL 
INCREMENT ROW COUNTER 
INCREMENT KEY STORAGE 
GET NEXT ROW INTO BC 
GET VALUE OF C FOR TEST 
BOH IS SHIFT KEY ROW 
LOOP BACK IF NOT SHIFT 
NUMBER OF BUMPS TO DO 
DECREMENT BYTE STORAGE 
ADD TOTAL VALUE STORED 
LOOP BACK FOR 7 TIMES 
WERE NO KEYS PRESSED? 
CLEAR ACC, NOT FLAGS 
BACK TO MAIN ROUTINE 
SAVE VALUE IF ZERO 
BACK TO MAIN ROUTINE 
TEST IF SAME CHARACTER 
IF SAME, JUMP OUT ... 
GET COUNTER BYTE INTO A 
INCREMENT IT EACH TIME 
SAVE IT AGAIN FDR NEXT 
IS IT PAST FULL DELAY? 
IF NOT GO BACK FOR MORE 
DEC A TO OFE FOR REPEAT 
SAVE THAT VALUE IN CNTR 
GET ORIGINAL CHARACTER 
SAVE THAT VALUE IN HL 
SAVE ROW COUNTER 
GET DELAY VALUE READY 
CALL ROM DELAY SUBROUT. 
RESTORE ROW COUNTER 
GET VALUE AT ROW CNTR. 
TEST IF STILL PRESSED 
IF NOT THEN IT'S BOUNCE 
SAVE ROW COUNTER AGAIN 
SAVE STORAGE AREA 
SAVE CURRENT KEYSTROKE 
GET DURATION VALUE 
GET STATUS OF SCREEN 
CLEAR THE DATA OUTPUT 
H BECOMES OUTPUT MASK 
READY ACC. FOR BIT-SET 

Listing Continued , , . 



Packing BASIC With Machine Code 

One of the most attractive aspects of 
interpreted code like Level II BASIC is the 
hide-n-seek game you can play with it. One of the 
most fruitful games is called 'string packing', a 
technique that allows machine language 
programs to be hidden inside ordinary program 
lines. 

It is convenient and efficient, but once it's part 
of a program, it looks very obscure. There are 
three ways of creating machine-coded programs 
through BASIC strings, but all depend on the 
code being relocatable (see Supplement to 
Chapter 4 regarding relocatable code). The three 
ways are: 

1. Packing the machine code into a string 
on a program line, one character at a time. 
This is done when the program is created. 

2. Packing the machine code into a string 
on a program line, one character at a time, 
reading data on other program lines. This is 
done each time the program is run. The 
read/data lines containing the packing 
information are then automatically deleted. 

3. Building a string in the string variable 
area from in-line CHR$() commands. The 
strings are built each time the program is 
run. 

First, some background on strings and how to 
find them. In the TRS-80, all variables can be 
located with a Level II command known as 
VARPTR (VARiable PoinTeR). The variable 
pointer can find out a lot about variables - their 
type, location, and length. In the case of string 
variables, VARPTR returns a memory location 
in which the length of the string is stored. 

Assume A$ is a string variable in a program 
line. The statement X=VARPTR(A$) assigns 
the address of the first part of the A$ story to X. 
Here's what X can reveal: 

PEEK [XJ ...the Length of AS 

PEEK (X+1) ...the least significant byte of share AS 1b found 

PEEK IX+2J ...the meet significant byte of share AS 1e found 

These values are returned in decimal form, 
because Level II doesn't provide a hexadecimal 
numbering option. To find where A$ is actually 
located, then, use this formula: 

AD = PEEK (X+1) + 256 * PEEK CX+2) 

Do you see what is happening here? And what 
can be done with it? If you know, for example, 
that A$="XXXXXXXXXX", then you can 
actually change A$ by POKEing values into the 
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Continued Listing 



6052 6F 


00800 




LD 


L,A 


; L BECOMES OUTPUT MASK 


5D53 7D 


00810 


SOUND 


LD 


A,L 


; GET BIT-SET MASK 


5D54 D3FF 


00820 




OUT 


[OFFHJ.A 


; OUTPUT IT (WAVEFORM HI) 


SDS6 7C 


00830 




LD 


A,H 


; GET BIT-RESET MASK 


5057 D3FF 


00840 




OUT 


(OFFH) ,A 


; OUTPUT IT (WAVEFORM LO) 


5059 C5 


00850 




PUSH 


BC 


i SAVE DURATION VALUE 


5D5A 0640 


O0B6O 




LD 


B,40H 


; GET PITCH VALUE 


5D5C 10FE 
505E C1 


00870 




DJNZ 


$ 


• DELAY FOR AUDIBLE TONE 


00880 




POP 


BC 


i RESTORE BEEP DURATION 


5D5F 10F2 


00890 




DJNZ 


SOUND 


, LOOP FOR FULL DURATION 


5061 F1 


00900 




POP 


AF 


RESTORE KEYSTROKE VALUE 


5062 E1 


00910 




POP 


HL 


RESTORE STORAGE VALUE 


5063 C1 


00920 




POP 


BC 


RESTORE ROW COUNTER 


5064 C30744 


00330 
00940 




JP 


4407H 


JUMP INTO EDTASM...I 




00950 


tttittttmmttmmimmtmttmtttitmttmim 




00960 


FOLLOWING PATCH NEW SOURCE CODE START Si KEYBOARD SCAN 




00970 


ttttttmttttmtttHiltitliittHMtttttttttttimfHH 




00980 










46 BA 


00990 




ORG 


46 BAH 


PLACE TO PATCH END 


468A 21005E 


01000 




LD 


HL.5ED0H 


NEW END OF EDTASM 


4710 


01010 




ORG 


471 OH 


PLACE TO PATCH END 


4710 11005E 


01020 




LO 


0E,5E00H 


NEW END OF EDTASM 


4A07 


01030 




ORG 


4A07H 


PUCE TO PATCH END 


4A07 11005E 


01040 




LD 


DE,5E00H 


NEW END OF EDTASM 


4ADB 


01050 




ORG 


4ADBH 


PLACE TO PATCH END 


4ADB 21005E 


01060 




LD 


HL,5E00H 


NEW END OF EDTASM 


4B50 


01070 




ORG 


4B50H 


PLACE TO PATCH END 


4B50 S1005E 


010BO 




LD 


HL.5E00H 


NEW END OF EDTASM 


4039 


01090 




ORG 


4D39H 


PLACE TO PUCE END 


4D39 21005E 


01100 




LD 


HL.5E00H 


NEW END OF EDTASM 


4080 


01110 




ORG 


4DB0H ; 


PUCE TO PATCH END 


4080 21005E 


01120 




LD 


HL.5E00H ; 


NEW END OF EDTASM 


5227 


01130 




ORG 


5227H j 


PUCE TO PATCH END 


5227 21005E 


01140 




LD 


HL.5E0DH ; 


NEW END OF EDTASM 


43 EF 


01150 




ORG 


43EFH ; 


PUCE TO PATCH KBD SCAN 


43EF C3005D 


01160 
01170 ; 




JP 


5D0OH ; 


NEW KEYBOARD SCAN 




01180 ; 


t§ttttttnn***ittii§itiittttn 


######f###ff#fff##f#f#ff 


5000 


01190 




END 


5DD0H 




00000 TOTAL 


ERRORS 










30935 TEXT AREA BYTE 


S LEFT 








FOUND 5026 


00540 


0370 








LOOPX 5008 


00340 


0440 








LOOPY 5019 


00460 


0480 








REDOIT 5D0E 


00390 


0600 








SAME 5D39 


00640 


0550 








SOUND 5D53 


00810 


0B90 









Packing BASIC With Machine Code 

address you have calculated. 

Run the following demonstration program: 

10 CLS 

20 A« = "XXXXXXXXXX" 

30 X = VARPTRtAO 

40 = PEEK (X) 

50 AD = PEEK [X+1 ) + 258 • PEEK IX+2) 

60 PRINTAS 

70 L = 65 

BO FOR N = 1 TO Q 

90 POKE AD,L 

100 L = L + 1 

110 AD = AD + 1 

120 PRINT AS 

130 NEXT N 

140 LIST 20 

A$ is created in line 20, and its information 
storage area is found by X in line 30. Its length is 
discovered in line 30 and assigned to variable Q; 
its location is determined in line 50 (assigned to 
variable AD), and it is printed in its original form 
in line 60. Line 70 assigns the value 65 (an ASCII 
'A') to variable L, and a Q-character loop is 
created in line 80. The first character in A$ is 
POKEd with L, i.e., changed to letter 'A'. L is 
incremented (to letter 'B'), AD is incremented 
(to the next character in A$), and the new A$ is 
printed. When all characters in A$ have been 
changed, it is listed. You can see that the list 
itself is changed because A$ is defined and stored 
right there in line 20! 

As a further experiment, change the value of L 
in line 70 to 129 and watch what happens (see 
Box on Tokenizing for details). 

Here is the point: you can create a dummy 
string like A$ which will become the residence of 
a machine language program. By finding A$ and 
POKEing your program into it, it can be 
CLOADed and CSAVEd at will. 

Now we turn to the three string-packing 
methods themselves. For the sample program, 
the following 20-byte routine will be used: 



21 01 3C 


LD 


HL.3C01H 


E5 


PUSH 


HL 


D1 


POP 


DE 


2B 


DEC 


HL 


01 FF 03 


LD 


BC.03FFH 


36 20 


LD 


(HL) ,20H 


ED BO 


LOIR 




21 11 01 


LD 


HL.0111H 


CD A7 28 


CALL 


2BA7H 


C9 


RET 





This routine clears the screen, prepares the 
message 'RADIO SHACK LEVEL II BASIC, 
and displays it. 

The first and second string-packing methods 
are essentially identical, except that in the first 
method, A$ is created and the program saved for 
later use. The second method creates A$ at every 
program run. Here is a simple BASIC program 
using the routine above packed into A$: 
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4F60 
4FB0 
4FB4 



4F67 
4F68 
4F6B 
4F6E 
4FBF 
4F72 
4F75 
4F7B 



4F7B 
4F7C 
4F7E 
4F7F 
4F8Q 
4FB3 
4FB5 
4F86 
4FB7 
4F8A 
4FBC 
4FBD 
4F8E 
4F91 
4F93 
4F94 
4F95 
4FS8 
4F8A 



00310050 
D1FF4F 



D9 

DD4600 

DD4E01 

D9 

DD6602 

DD6EQ3 

DDS604 

DD5E05 



DA 

EBDF 

34 

25 

C2B54F 

CBE7 

2C 

20 

C28C4F 

CBEF 

14 

15 

C2934F 

CBF7 

1C 

1D 

C28A4F 

CBFF 

02 



4F9B 
4F9C 
4FS0 
4FA0 
4FA2 
4FA5 
4FA8 
4FAA 
4FAC 



4FAE 
4FAF 
4FB2 
4FB4 
4FB7 
4FBA 
4FBC 
4FBE 



OA 

25 

C2AB4F 

EE01 

DDBB02 

C3AE4F 

FDE5 

F0E1 

E6FF 



20 

C2BA4F 

EE02 

DD6E03 

C3004F 

FDE5 

FDE1 

EBFF 



4FC0 
4FC1 
4F04 
4FC6 
4FC9 
4FC0 
4FCE 



15 

C2CC4F 

EE04 

D05604 

C3D24F 

FDE5 

FDE1 



00100 

00110 

00120 

00130 

00140 

00150 

001S0 

00170 

00180 

00190 

00200 

00210 

00220 

00230 

00240 

00250 

00260 

00270 

00280 

00290 

00300 

00310 

00320 

00330 

00340 

00350 

003B0 

00370 

003B0 

00390 

00400 

00410 

00420 

0043 

00440 

00450 

00460 

00470 

00480 

00490 

00500 

00510 

00520 

0053 

00540 

00550 

00560 

00570 

005B0 

00590 

00600 

00610 

00620 

00630 

00640 

00650 

00660 

00670 

00680 

00690 

00700 

00710 

00720 

00730 

07 40 

00750 

00760 

00770 

00780 

00790 

00800 

00810 

00820 

00B30 

0840 

00B50 

00860 

00B70 

008 B0 

00880 

00900 

00910 

00920 

00930 

00940 

00950 

00960 

00970 

00980 

00990 

01000 

01010 

01D20 

01030 

01040 

01050 

01060 

01070 

010BO 

01090 

01100 

01110 

01120 

01130 



ORO 


4F60H 


ID 


IX.5000H 


LD 


BC.4FFFH 



EXX 






LD 


B 


IIX+O) 


LD 


C 


(IX+11 


EXX 






LD 


H 


tIX+2] 


LD 


L 


(IX+3) 


LD 


D 


(IX+4) 


LD 


E 


iIX+5) 



ELEHENTARY IAND SLOW) FOUR-VOICE MUSIC SUBROUTINE. 
THIS ROUTINE IS CURRENTLY SET UP FOR FOUR INDEPENDENT 
VOICES. BECAUSE OF TIMING CONSTRAINTS, VOICES ARE VERY 
LOW IN PITCH. BY USING THE FOUR SUBROUTINES ALTERNATE- 
LY FOR SOUND EFFECTS. A HIGHER SPEED CAN BE OBTAINED. 
A TEST-AND-JUMP LOOP CAN BE INSERTED FOR THIS PURPOSE. 
ALSO, AS LONG AS LABELS ARE CHANGED, VOICES CAN BE 
DROPPED FROM THE SEQUENCE, RESULTING A 50%, 100% AND 
150* SPEED INCREASE, RESPECTIVELY. SQUARE WAVE OUTPUT. 
NOTICE ALSO THAT, WHEN VOICES ARE DROPPED, OTHER REG- 
ISTERS MAY BE SUBSTITUTED FOR IX, FOR A SPEED INCREASE. 
FURTHERMORE, CHANGING THE SPEED OF THE PROCESSOR WILL 
PROVIDE AN IDENTICAL INCREASE IN THE OUTPUT PITCH. 
###################################*###* ############### 

NEAR TOP OF MEMORY 
START PITCH a RHYTHM 
MEMORY-MAPPED SOUND 

tttttttiittttttttfttttttttt*t*IHII*tt*t**t*tt***t***t* 

OUTER tINTER-NOTE] LOOP BEGINS HERE; T-STATES 212 - 244 
##tfff#«ff*f##»##ff#####f###f****f ###'*######*#**#**#** 

04:READY DURATION REGS. 
19:MSB OF NOTE DURATION 
19:LSB OF NOTE DURATION 
04:STASH REGISTER AWAY 
19:FIRST PITCH INTO H 
19:SECON0 PITCH INTO L 
19:THIRD PITCH INTO D 
19:F0URTH PITCH INTO E 

##########*##############«##*####*####******♦********* 

EACH VALUE ACQUIRED FROM IX IS TESTED TO SEE IF IT IS 
AND THE VOICE IS TURNED OFF IF IT IS (DEFINING A REST). 

tttttltttttttttitttfttttitttttttttfttttttttttttttttittt 

07:READY TO TWEAK MEM 
04:TURN ALL VOICES ON 
04:BUMP VALUE; REST TEST 
04:BUMP VALUE; REST TEST 
10:0NLY 00 DEFINES REST 
OBtSILENCE VOICE IF REST 
04:BUMP VALUE; REST TEST 
04:BUMP VALUE; REST TEST 
10:ONLY 00 DEFINES REST 
08;SILEN0E VOICE IF REST 
04:BUMP VALUE; REST TEST 
04:BUMP VALUE; REST TEST 
10:0NLY 00 DEFINES REST 
08;SILENCE VOICE IF REST 
04:BUMP VALUE; REST TEST 
04:BUMP VALUE; REST TEST 
10:0NLY 00 DEFINES REST 
OB;SILENCE VOICE IF REST 
07:SET VOICES ON OR OFF 

DECREMENT H.L.D.E (WAVEFORM DURATION FOR EACH VOICE]... 
NEEDED EACH TIME THE WAVEFORM IS TOGGLED DURING LOOPS.. 
...INNER LOOP BEGINS HERE. T-STATES STRICTLY EQUAL 24B 
MEANING MAXIMUM FREQUENCY IS APPROXIMATELY 1770000/246 
OR 7195.1 HZ. USEFUL FREQUENCIES ARE CONSIDERABLY LESS. 

tun ittnttttttitiniiittitt*ftttttittttttttt**ft*tiii 

BEGIN PITCH AND RHYTHM COUNTDOWN LOOPS 

COUNT DOWN THE PITCH LOOP FOR VOICE NUMBER ONE 
mHttfftttHHHflHt*lltttitttt*ttt*ittHtltt§tHHt 

07:WHAT WAVE IS LURKING 
04:C0UNTD0WN FREQUENCY 1 
10:SAME WAVE IF NOT 
07:TOGGLE WAVEFORM BIT 1 
19:REST0RE PITCH VALUE 
10: JUMP PAST TIMEWASTERS 
15:WASTE 15 T-STATES 
14:WASTE 14 T-STATES 
07:WASTE 7 MORE T-STATES 

HUtttHtHtttlttttttttttttitttttitittttHtttttttttHt 

COUNT DOWN THE PITCH LOOP FOR VOICE NUMBER TWO 

ttSttftttttHttttttttttlttHtttitttfttttttttttSttlttttttt 

04:C0UNTD0WN FREQUENCY 2 
10:SAME WAVE IF NOT 
07:T0GGLE WAVEFORM BIT 2 
19:REST0RE PITCH VALUE 
10: JUMP PAST TIMEWASTERS 
15:WASTE 15 BANANAS 
14:DRUM FINGERS ON 14 
07:USELESS ARITHMETIC 

ttittttttnnititttttttmumtutttntttttiiiHutut 

COUNT DOWN THE PITCH LOOP FOR VOICE NUMBER THREE 

tttfttttttttfitttSttttttfttlttlttttttttttttHttttttttttt 



LD 


A,(BCJ 


AND 


OFH 


INC 


H 


DEC 


H 


JP 


NZ.REST1 


SET 


4, A 


INC 


L 


DEC 


L 


JP 


NZ.REST2 


SET 


5, A 


INC 


D 


DEC 


D 


JP 


NZ.REST3 


SET 


6 .A 


INC 


E 


DEC 


E 


JP 


NZ.REST4 


SET 


7. A 


LD 


(BC) ,A 



LD 


A,(BC] 


DEC 


H 


JP 


NZ.EXIT1 


XOH 


1 


LD 


H,(IX+2) 


JP 


EXIT1A 


PUSH 


IY 


POP 


IY 


AND 


OFFH 



DEC 


L 


JP 


NZ.EXI 


XOR 


2 


LD 


L.UX+ 


JP 


EXIT2A 


PUSH 


IY 


POP 


IY 


AND 


OFFH 



DEC 

JP 

XOR 

LD 

JP 

PUSH 

POP 



NZ.EXIT3 

4 

D.UX+4] 

EXIT3A 

IY 

IY 
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04:C0UNTD0WN FREQUENCY 3 
10:SAME WAVE IF NOT 
07:T0GGLE WAVEFORM BIT 3 
19:REST0RE PITCH VALUE 
10:JUMP PAST TIMEWASTERS 
16:SCRATCH LEFT HAND 
14:SCRATCH RIGHT HAND 

Listing Continued , . 



5 POKE 16553,255 : REM OPTIONAL LINE 

10 PRINT"THE PROGRAM IS RUNNING" 

20 AS = "12345678901234567890" 

30 X = VARPTR (AS) : = PEEK (X) 

40 AD = PEEK CX+1 ) + 256 * PEEK CX+2) 

50 FOR N = 1 TO Q : READ A 

60 POKE AD,A : AD = AD + 1 : NEXT 

70 HB = PEEK (X+1) : POKE 16526 ,HB 

80 LB = PEEK (X+2) : POKE 16 527, LB 

90 INPUT"ENTER TO RUN M/L";Z 

100 MS = USR (0) 

110 DATA 33,1,60,229,209,43,1,255,3,54 

120 DATA 32,237,176,33,17,1,205,167,40,201 



Line 5 is optional if you have an early ROM set, 
where data reads could RESTORE after every 
READ. Line 20 contains the string to be packed, 
and, as before, lines 30 and 40 identify the 
string's length and location. The data is read and 
POKEd into place sequentially by lines 50 and 
60. 

Finally, lines 70 and 80 identify the beginning 
of the string and place it in the USR(X) entry 
points at 16526 and 16527. The program pauses 
for user input in line 90, and then jumps to the 
packed routine. 

After the program has been run, list it. Note 
that A$ is now packed with new information 
replacing the string '12345678901234567890'. 
The first string-packing method saves space by 
deleting lines 40 through 60, 110 and 120, which 
have done their work. The program is then 
CSAVEd, and can be loaded and run at any time. 
The second string-packing method leaves all 
lines intact so that any future users may modify 
them as necessary. 

There are a few disadvantages to this method 
of string packing. First of all, two machine 
language instructions or pieces of data may not 
be used directly: 00 and 22. 00 tells a BASIC 
program it has found the end of a program line; 
two 00's in a row indicate the end of the program. 
22 is the quotation mark symbol, and will inform 
the program that the string has ended; a ?SN 
ERROR will then be produced in the rest of the 
line. 

A second difficulty is that the line containing 
A$ may not be edited. This is because when a line 

is edited, it is placed from the LIST into a buffer 
that acts exactly like the keyboard buffer; the 
bytes within the quotes are then converted into 
the individual letters. For example, code (178) is 
a machine command which also is the BASIC 
token for PRINT; when listed, it comes up on the 
screen as PRINT. Editing the line puts 
P-R-I-N-T in the edit buffer; but since it is 
within the quotation marks, it is not tokenized. 
The result? The string now contains five ASCII 
characters where it once contained a machine 
language instruction! 



Packing BASIC With Machine Code 



Continued Listing 




4FD0 


E6FF 


01140 
01150 


AND OFFH ;07:CHECK KITCHEN CLOCK 






01160 


; ttlltUlttllltHHHtHtHtlttttHititlHtitililttlltti 






01170 


; COUNT DOWN THE PITCH LOOP FOR VOICE NUMBER FOUR 






01180 


; WttttttlHltttttttlltttt*IHttttttilttt*ttHilfHttltt 






01190 




4FD2 


1D 


01200 


EXIT3A DEC E ;04:C0UNTD0WN FREQUENCY 4 


4FD3 


C2DE4F 


01210 


JP NZ.6XIT4 :10:SAME WAVE IF NOT 


4FD6 


EEQ8 


01220 


XQR 8 ;07:TDGGLE WAVEFORM BIT 4 


4FDB 


DD5EQ5 


0123 


LD E.UX+5) ;19:REST0RE PITCH VALUE 


4FDB 


C3E44F 


01240 


JP EXIT4A ;10:JUMP PAST TIMEWASTERS 


4FDE 


FDE5 


01250 


EXIT4 PUSH IY ;15:WATER NASTURTIUMS 


4FE0 


FDE1 


0126 


POP IY . ;14:PICK 14 ZUCCHINI 


4FE2 


E6FF 


01270 
01280 


AND OFFH ;07:MIX APPLES AND ORANGE 






01290 


; ttlWHtttttttttttitttltltittttHttitttfHttttlttttttH 






01300 


; CHECK FOR END OF NOTE DURATION: GET MORE NOTES IF DONE 






01310 


: ttHtttttltHttlHtttttHHttMHtHHHHttttttHit»ll 






01320 


; ~"~ 


4FE4 


02 


01330 


EXIT4A LD (BCJ ,A ;07:0UTPUT NEW WAVEFORMS 


4FE5 


oa 


01340 


EXX ;04:GET STASHED DURATION 


4FE6 


OB 


01350 


DEC BC ;06:COUNT DOWN DURATION 


4FE7 


7B 


01360 


LD A,B i04:SET UP B FOR TEST 


4FEB 


B1 


01370 


OR C :04:CHECK AGAINST C 


4FE9 


D9 


01380 


EXX ;04:STASH DURATION AGAIN 


4FEA 


C29B4F 


01390 
01400 


JP NZ.L00P2 ;10:G0 BACK TIL NOTE END 






01410 


; ««#»«###«#«##«#############################«#### 






01420 


; MOVE ALL POINTERS PAST CURRENT BATCH OF NOTES/DURATIONS 






0143 


; ...THIS IS THE REMAINDER OF OUTER LOOP. T-STATES = 80, 






01440 


: TOTAL T-STATES OF OUTER LOOP = BO + 244 = 324. WHICH IS 






01450 


; ABOUT 2 OF THE MAXIMUM CYCLE FREQUENCIES t .0002 USEC). 






01460 


; tgtttttStttSStSittttttfttKSttittettftfttttttttittttttt 






0147 




4FED 


110600 


014B0 


LD DE.6 ;10:MEMORY POS'NS TO MOVE 


4FF0 


DD19 


01490 
01500 


ADD IX, DE ;15:M0VE B PLACES FORWARD 






01510 


i t*ittt*ttttt*ttttttt*tttttt*1ttlttttttttttttHtlttttttt 






01520 


: CHECK FOR END OF PROGRAM CODE (00] OR DEPRESSED BREAK 






01530 


; tttttttttttttttttttittttttttttmttttttttttttttttlttttt 






01540 




4FF2 


DD7EDD 


01550 


LD A,iIX+0) :19:NEXT NOTE DURATION 


4FF5 


B7 


0156 


OR A ;04:SET END-OF-MUSIC FLAG 


4FF6 


CB 


01570 


RET Z ;05:BACK TO BASIC IF DONE 


4FF7 


3A403B 


015B0 


LD A,(3840H) ;13:TEST BREAK KYBD ROW 


4FFA 


B7 


01590 


OR A ;04:SET FLAG FOR KEY TEST 


4FFB 


CA674F 


01600 


JP Z.L00P1 ;10:C0NTINUE PIECE IF OK 


4FFE 


C9 


01610 
01620 


RET ; :T0 BASIC IF BREAK 






01630 


; tttttittttttttttttlt ################«##########*##«## 






01640 




06CC 




01650 


END 06CCH ; :READY AFTER SLASH 


OOOOC 


TOTAL 


ERRORS 





The last method of string packing is capable of 
overcoming both these flaws. Examine the 
listing below: 



10 PRINT"THE PROGRAM IS RUNNING" 
20 AS = CHRS(33) + CHRSH) + CHRSC60) + 
CHRSC229] + CHR$[20g) + CHR$(43) 
CHRSIU + CHR$(255! + CHRS(3) + 
CHRS[E4] + CHRS132) + CHRSC237) 4 
CHR$t176) + CHRS(33] + CHRSH7) -t 
CHR$(1) + CHRS(205) + CHRS[167) •* 
CHRSC40) + CHRSI201) 



30 X = VARPTR (AS) 

40 POKE 16526, PEEK (X+1 1 

50 POKE 16527, PEEK (X+2) 

60 INPUT "ENTER TO RUN M/L";Z 

70 MS = USRtO) 



This time, A$ has been defined in the BASIC 
variable area using CHR$(). In other words, 
because A$ is no longer defined within the 
program line, any value may be used in the 
machine language program. Hybrid strings can 
also be used, as: 

AS = "1234567890" + CHRS(O) + "12345" + CHRS134) 

This method uses both the POKEing via 
READ-DATA statments, plus concatenation 
with 00 and 22 where necessary. Once again, A$ 
is stored in the variable area, and none of the 00's 
or 22's affect the BASIC program. As a final 
amusement, RUN listing 3-(?) above, then 
PRINT A$. The A$ in listing 3-(?) and the A$ in 
this listing both contain identical machine code. 
RUN listing 3-(?) again. LIST line 20. Now 
PRINT A$. The answer is up to you. 

String-packing will likely become a very 
important addition to your library of BASIC 
tools. Here, then, is a summary of the 
string-packing technique: 

1. Write the BASIC program. 

2. Create a dummy string of any unused 
variable name (for example, 
A$="LOONIETUNES" 

3. Make the string the exact length of your 
machine language program. 

4. Write a program line that sets another 
variable to point to the string's variable 
information. 

For example, X = VARPTR(A$). 

5. Find the starting address of the string by 
converting the decimal bytes into a single 
decimal value. 

AD = PEEK(X-t-l) + 256 * PEEK (X+2). 
6. Create a set of READ and DATA lines in 
your BASIC program which will POKE the 
machine language program into place in the 
dummy string. (For example: 



Line t FOR N = AD TO AD+3 : READ L 
Line # DATA 33, 16, 16, 204 



POKE N,L : NEXT 
1 



7. Set the USR(O) entry point at 16526 and 
16527 to the beginning of the string variable 
storage address (for example, PEEK (X+1) 
and PEEK (X+2), respectively. 

8. If you wish, delete the READ, DATA and 
POKE loop lines used for that routine. 
CSAVE the program. 
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Sound-Effects Generation 



0000 
0003 
0004 
000S 
0006 
0007 
0009 
000C 
000E 
0010 
0011 
0013 
0015 
0017 
0010 
001A 



CD7F0A 

E5 

C1 

C5 

41 

10FE 

3A3D40 

F602 

D3FF 

41 

10FE 

E6FD 

D3FF 

C1 

10EB 

CO 



0000 

00000 TOTAL ER 

LOOP 0005 



00100 

00110 

00120 

00130 

00140 

00150 

00160 

00170 

00180 

00180 

00200 

00210 

00220 

00230 

00240 

00250 

00260 

00270 

00280 

00290 

00300 

00310 

00320 

00330 

RORS 

00180 



Sound-Effects Generation 

The essence of sound generation has already 
been sneaked in: the audible beep in the 
keyboard routine at the beginning of this 
Chapter. Sound has been something of a 
mystery, but there could hardly been a simpler 
machine language program. Try this 
experimental program with the tape recorder 
running in record mode (the motor plug 
removed), and a cassette in place: 

10 F0RX=1T02000:0UT255,0:0UT255,255:NEXT 

In order that this program can operate at top 
speed, make sure you do not use spaces, and keep 
the program on one line. You'll hear the tape 
relay clatter and see the screen jitter. Now play 
back the short segment of tape you recorded. 
There is a buzzing on that tape, similar in pitch to 
the buzzing of the cassette relay. What does all 
this mean? 

It is quite simple. There is an electronic switch 
inside the TRS-80 which controls several 
activities: whether the screen is in 64 or 32 
character mode, whether the cassette relay is on 
or off, and whether the cassette data output is 
'on' or 'off. 

I've put on and off in quotation marks for a 
reason: which video mode is used and whether 
the cassette motor is on or off are examples of 
states or conditions. But in audio terms, the 
latter output represents very swift sound wave 
transitions, not on or off conditions. In other 
words, the transition from on to off or from off to 
on can be heard as only a slight click; but many of, 
them in quick succession sound like a buzz; in 
even faster succession, they become actual 
pitches. 



SINGLE-VOICE MUSIC SUBROUTINE FOR USE WITH CASSETTE 
OUTPUT PORT CAN BE EMBEDDED DIRECTLY IN A BASIC STRING 
IttttlltitttllttltltHiltlltltlli tttttttt HttHHIHIH 



CALL 



0A7FH 



ACCEPT BASIC VARIABLE 
STASH BASIC VARIABLE 
TRANSFER VAR. TO BC 
SAVE OUTER LOOP VAR. 
BET MSB FOR TONE 
ANO DELAY THAT TIME 
GET SCREEN STATUS 
AND SET BIT ONE 
OUTPUT PART OF WAVE 
GET VARIABLE AGAIN 
DELAY WHILE WAVE HIGH 
AND SET OTHER BIT HIGH 
TO DO OTHER WAVE HALF 
RESTORE OUTSIDE VALUE 
AND LOOP BACK FOR FREtt. 
GO BACK TO BASIC 



###*# ittt*tttttttttittttttt*tttUtH*tltHtttittttttH* 

END 



PUSH 


HL 


POP 


BC 


PUSH 


BC 


LD 


B.C 


DJNZ 


S-0 


LD 


A,[403DH] 


OR 


2 


OUT 


(OFFH) .A 


LD 


B.C 


OJNZ 


S-0 


AND 


OFDH 


OUT 


(OFFH) .A 


POP 


BC 


DJNZ 


LOOP 


RET 





The single-line BASIC program, short though 
it may be, cannot move fast enough to produce 
pleasant tones or dramatic sound effects. For 
that you must turn to machine language for its 
speed. Listing 3-(?) presents a complete sound 
subroutine with ten sample sounds built in. 

Listing 3-(?) presents a different sound 
subroutine which accepts values passed from 
BASIC. 

Again, each program has an advantage. The 
first allows you to tailor specific sounds and their 
durations and repetitions with care; the second 
lets you develop many different sounds easily, 
directly from BASIC, without altering the 
machine subroutine already in place. 



What's in a List? 

Often it's reassuring to be able to give your 
program to others without having to worry about 
gratuitous examination of your code, and finding 
your own, carefully developed techniques in 
someone else's product. The easiest thing to do, 
then, is UN-LIST the program. 

Actually, the program still LISTS, but can't be 
seen; and the program still LLISTs, but uses a 
whole sheet of paper for each line. In either case, 
it's a discouragement if you've got some code you 
like. And protecting just a few lines might give 
the impression that's all there is to your program 
- a psychological ploy. 

The trick is to add two bytes to the end of the 
program: the command to 'Home Cursor', and 
the command to 'Form-Feed'. Here are a few 
normal program lines: 



REMK& 

1 CLS:PRINT:PRINT:PRINT"CHANGING...":X=1712S:REM&& 

2 X=PEEKtX)+256»PEEKCX+1):PRINTX"... ";:REM&& 

3 IFX=0THEN10ELSEP0KEX-2,28:P0KEX-3,12:G0T02:REM&& 
10 PRINT :PRINT"THIS IS A TEST ";:REM&& 

20 PRINT'OF A TECHNIQUE TO KILL"::REM&& 

30 PRINT'THE FEATURE THAT LISTS"; :REH&& 

40 PRINT"0R LLISTS THE PROGRAM. »:REM&& 

50 PRINT'THE PROGRAM HAS NOW BEEN CHANGED" :REMaS 

60 PRINT"A COMPLETE LIST FOLLOWS ":REH&& 

70 LIST:REMB& 
80 REM&S 



This process uses four bytes per line (colon, 
REM, two ampersands), and diminishes the 
usable characters per line by six, but if you have 
the memory and think you need a little 
protection, this is a way to go. Delete lines 1, 2 
and 3, and save the program. When LIST is 
commanded, nothing will list on the screen but 
two REM lines (0 and 80). The program will 
require nine sheets of paper to LLIST. 
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Chapter 3 



Autoexecute BASIC Programs 



1D7B 



7F00 

7FD0 2AQ440 
7F03 22587F 
7FD6 210F7F 
7F09 220440 
7F0C G3GC06 



7F0F E3 
7F10 70 
7F11 FESB 
7F13 2003 
7F15 7C 
7F16 FE1D 
7F18 E3 
7F19 G2577F 



7F1C CD7B1D 
7F1F F5 
7F20 FEB9 
7F22 2804 
7F24 F1 
7F25 SB 
7F26 1B2F 



7F28 F1 
7F29 2A1640 
7F2C 22557F 
7F2F 21427F 
7F32 221 840 
7F35 21E941 
7F3B 3600 
7F3A 2B 
7F3B 3EB9 
7F3D DBBO 
7F3F C36S1D 



00100 ; stmtttmuttnntsuttsmtiuttmmtnnntntnt 

00110 i BASIC AUTOEXECUTION ROUTINE PATCH FOR LEVEL II BASIC 

00120 ; Mtt*ttMtMttitttnt*ttnttttni**ttttt»tn**ttmttit 

00140 BYTE EOJJ 1D7BH ; INTERPRETER CALL ADDR. 

00150 

00160 ; **mtnntM*ntttttttntt*t*tttt*t»ttttt*ttiim*ttt* 

00170 
001 BO 

00190 START 
00200 



7F42 2A557F 
7F45 221640 
7F48 21EB41 
7F4B 368E 
7F4D 23 
7F4E 3600 
7FS0 2B 
7F51 2B 
7F52 C35A1D 



00210 

00220 

00230 

00240 

00250 

00260 

00270 

002B0 

00290 ENTRY 

00300 

00310 

00320 

00330 

00340 

00350 NOTRDY 

00360 

00370 

003 BO 

00390 

00400 

00410 

00420 

00430 

00440 

00450 

00460 

00470 

00480 

0Q490 

00500 

00510 

00520 

00530 

00540 

00550 

00560 CLOAD 

00570 

005B0 

00590 

00600 

00610 

00620 

00630 

00640 

00650 

00660 

00670 ; 

00680 

00690 

00700 

00710 

00720 

00730 

00740 

00750 ; 

00760 BYPASS 

00770 



ORG 

LD 

LD 

LD 

LD 

JP 



7F00H 
HL,(4004H) 
(RETURN) ,HL 
HL. ENTRY 
[4004H),HL 
06CCH 



RELOCATE IF DESIRED 
GET INTERPRETER PATCH 
CHAINING PROCESS HERE 
ENTRY OF AUTOEXEGUTOR 
PATCH INTO INTERPRETER 
RETURN TO BASIC READY 



ittmtttmtitttttnttnntttttttttttttttttttttttttttt 

CHECK FOR STATUS OF INTERPRETER (MUST BE AT 1D5BH) 

ttntttffltmtttttnttttttttttmtttHtmtttttttttttt 



EX 

LD 
CP 
JR 
LD 
CP 
EX 
JP 



(SP),HL 

A,L 

5BH 

NZ, NOTRDY 

A,H 

1DH 

(SP1.HL 

NZ.AWAY 



GET RETURN ADDRESS 
GET LSB INTO A REG. 
CHECK LSB OF 1D5BH 
GO OUT IF NOT AT 1D5B 
GET MSB. INTO A REG. 
CHECK MSB OF 1D5BH 
RETURN STACK POSITION 
BEGONE IF NOT ID5BH 



t**t*ttttittntttttt*t**ttt*int*n******ti**tti**t*t*i 
COMPARE PRESENT LINE POSITION WITH CLOAD (TOKEN B9] 

ttttttmtttitttmmnttmtttmmttttmmtttmt 



CALL 

PUSH 

CP 

JR 

POP 

DEC 

JR 



BYTE 

AF 

QB9H 

Z, CLOAD 

AF 

HL 

AWAY 



GET NEXT BUFFER CHAR. 
SAVE PRESENT ACCUH. 
SEE IF CLOAD TOKEN 
SPECIAL ROUTINE IF B9 
RESTORE PRESENT ACCUM. 
RESTORE HL POINTER 
OUT TO NORMAL MODE 



n*ntt**ttttmtttttntmt*tttmtmntttttmmttt 

IF CLOAD TOKEN IS FOUND, EXECUTE CLOAD PROCESS, BUT 
FIRST INTERCEPT KEYBOARD SCAN (CRUDE WAY OF DOING IT) 
TO GRAB PROGRAM ON ITS WAY BACK TO A READY CONDITION 

HtttttittittttMttttitttttttttitttttttt*t*tttttttttttt 



POP 

LD 

LD 

LD 

LD 

LD 

LD 

DEC 

LD 

SUB 

JP 



AF 

HL,(4016H) 

(STORE) ,HL 

HL, BYPASS 

(4016H),HL 

HL,41E9H 

[HD.OO 

HL 

A,0B9H 

BOH 

1D65H 



CLEAR STACK OF AF REG. 
GET CURRENT KEYBRD SCAN 
SAVE IT FOR A WHILE 
GET VALUE OF ROUTINE 
PATCH INTO KEYBRD PLACE 
POINT TO BUFFER LOC'N 
PLACE END OF LINE CMD. 
BUMP HL BACK TO START 
GET CLOAD VALUE 
STRIP OFFSET VALUE 
BACK TO EXECUTION ROUT. 



MttttttttttttttttMMtttMltttmttttHttttHttttttttt 
CLOAD ABOVE WILL EXECUTE, RESET THE STACK, AND ATTEMPT 
TO RETURN TO A READY CONDITION. AT THIS POINT, THE 
KEYBOARD DRIVER INTERCEPT WILL REDIRECT THE PROCESSOR 
TO THE BYPASS ROUTINE BELOW, WHICH WILL AGAIN SET UP 
THE BUFFER, REPATCH THE KEYBOARD DRIVER, AND RUN. 



LD 

LD 

LD 

LD 

INC 

LD 

DEC 

DEC 

JP 



00780 
00790 
00800 
00B10 
00B20 
00830 
00840 
00850 
00B60 
00B70 
00B80 
00890 
7F55 ODOO 0090D STORE 
7F57 C3 D0910 AWAY 
7F5B 781 D 00920 RETURN 

00930 ; 
7F00 00940 END 
00000 TOTAL ERRORS 
31717 TEXT AREA BYTES LEFT 

AWAY 7F57 00910 003S0 00480 

BYPASS 7F42 0U76O 

BYTE 1D7B D0140 

CLOAD 7F2B 00560 

ENTRY 7FQF 0U290 

NOTRDY 7F1B UU350 

RETURN 7F5B 00920 

START 7F0U 0U190 

STORE 7F55 009DO 



HL, (STORE) 

(4016H1.HL 

HL.41EBH 

(HL),8EH 

HL 

(HD.OO 

HL 

HL 

1D5AH 



GET BACK KEYBRD SCAN 
PUT BACK INTO PLACE 
GET BUFFER LOCATION 
GET RUN COMMAND TOKEN 
BUMP UP BUFFER POS'N 
CLOSE OFF THE BUFFER 
BUMP BACK IN BUFFER... 
...TO THE RUN COMMAND 
AND THEN EXECUTE IT 



THE FOLLOWING FOUR BYTES ARE TEMPORARY KEYBOARD STORAGE 

ttmttttntuttttmtttttnttmttttttttitmtttitttt* 



DEFW 
DEFB 
DEFW 



00590 
00420 
U0450 
U0210 
00320 
00200 
U0S40 
00580 007B0 



0000 
0C3H 
1D7BH 

START 



TEMPORARY TWO-BYTE AREA 
JUMP COMMAND IN PLACE 
ORIGINAL VALUE CHANGES 

PATCH ROUTINE AT START 



Autoexecute BASIC Programs 

One of the pleasures of disk operating systems 
is the ability to load and run programs 
automatically. This can be done with tape 
systems as well, simply because all the Level II 
BASIC operations are organized as subroutines. 
Any one may be called at any time. To 
autoexecute a program, then: 

1. The SYSTEM command must be entered 
and the load begun in this mode. 

2. The SYSTEM tape must load over its 
own return point so that it can begin 
execution automatically. 

3. The SYSTEM program loaded must 
CALL the CLOAD routine, first preparing 
the stack to return to itself instead of 
command level. 

4. Upon return, the SYSTEM program must 
prepare the stack once again for return to 
normal Level II operation, and jump to the 
RUN routine. 

The process is straightforward with one 
exception: the CLOAD routine is terminal. That 
is, it forces a return to command level upon 
completion by clearing out the return address on 
the stack. It means that a program which might 
have been written in little more than a dozen 
bytes must instead play some memory hopscotch 
first. 

Before turning to this loading routine itself, 
here is a look at the heart of the autorun sequence 
itself - a mere thirteen bytes! Enter any short 
BASIC program first, then the routine below: 



5D0D 


21 E8 


41 


LD 


HL,41E8 


5003 


36 BE 




LD 


(HL) ,8E 


5005 


23 




INC 


HL 


5DDS 


36 00 




LD 


(HL) ,00 


5008 


2B 




DEC 


HL 


5009 


2B 




DEC 


HL 


500A 


C3 5A 


1D 


JP 


1D5A 



From BASIC, you can put this program in 
place with the following lines from command 
level: 



X=20480 : P0KEX.33 : POKEX+1 ,232 : POKEX+2,65 : 
POKEX+3,54 : POKEX+4,241 : POKEX+5,35 : POKEX+6,54 

POKEX+7,0 : POKEX+8,43 : POKEX+8,43 : POKEX+10,185 
POKEX+11,90 : POKEX+12,29 <ENTER>. 



This simple routine sets the HL register to 
point to the usual beginning of the keyboard 
input buffer, puts an 8E (the RUN command 
value) into that place, bumps the register one 
place forward, and puts a zero there. The HL 
register is bumped back to just before the 
beginning of the keyboard buffer, and the 
execution routine at 1D5A is entered. 
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Machine Language Monitor 







00100 


i tttttllttttttttmt »###«####* 


##f###*##ffft##ff##f#f" 






00110 


; MINIATURE MACHINE-LANGUAGE MONITOR DISPLAYING HEX/ASCII 






00120 


i ftttttt*fttl*IIHttt*t*till*tttittititiHIHHtttttttit 


06CC 




00130 


READY 


EOU 


06CCH 


RETURN TO READY INTACT 


1D78 




00140 


BYTE 


EOU 


1D78H 


ROM READ KEY & TOKENIZE 


1997 




00150 


SYNERR 


EQU 


1997H 


ENTRY POINT TO SN ERROR 






00160 


: «##i 


HttHftHHtttttt§ttitftttHittHttt§tHltHttHt 






00170 


: GET REST OF DATA AND CONVERT 




0000 


CD7810 


00180 


OPENER 


CALL 


BYTE 


NEXT CHARACTER IN LINE 


0003 


FE22 


00190 




CP 


22H 


IS IT A QUOTE MARK? 


0005 


C29719 


00200 




JP 


NZ, SYNERR 


OUT TO ERROR IF NOT 


0008 


E5 


00210 




PUSH 


HL 


SAVE LINE POINTER 


0009 


FDE1 


00220 




POP 


IY 


STASH POINTER IN IY 


OOOB 


CDFB00 


00230 




CALL 


XX99 


CONVERT CHARS TD HEX 


000E 


CD0901 


00240 




CALL 


01C9H 


CLEAR SCREEN (ROM CALL) 


0011 


184C 


00250 




JR 


NEXT99 


JUMP PAST SUBROUTINES 






00260 


: ###«* 


v¥virvWff& 


tttttittttttt #################«########## 






00270 


; GET 16 SCREEN 


POSITIONS READY (10H) 


0013 


7A 


00280 


CONTNT 


LD 


A.D 


GET ADDRESS LOW BYTE 


0014 


21403C 


00290 




LD 


HL.3C40H 


GET SECOND SCREEN LINE 


0017 


E6F0 


00300 




AND 


OFOH 


MASK OUT LOW BITS 


Q013 


CDE200 


00310 




CALL 


RRRRS 


ROTATE/DISPLAY ROUTINE 


001C 


7A 


00320 




LD 


A.D 


GET ADDRESS LOW BYTE 


001D 


E6 0F 


00330 




AND 


OFH 


MASK OUT HIGH BITS 


001F 


CDDBQ0 


00340 




CALL 


HEXASC 


CONVERT WORKS TO ASCII 


0022 


77 


00350 




LD 


tHLJ ,A 


DISPLAY THE CHARACTER 


0023 


23 


00360 




INC 


HL 


NEXT SCREEN POSITION 


0024 


7B 


00370 




LD 


A,E 


GET HIGH BYTE 


0025 


E6F0 


00380 




AND 


OFOH 


MASK OUT LOW BITS 


0027 


COE200 


00390 




CALL 


RRRRS 


ROTATE/DISPLAY ROUTINE 


002A 


7B 


00400 




LD 


A.E 


GET HIGH BYTE AGAIN 


002B 


E60F 


0041 




AND 


OFH 


MASK OUT LOW BITS 


002D 


CDD800 


00420 




CALL 


HEXASC 


CONVERT HEX TO ASCII 


0030 


77 


00430 




LD 


(HL) ,A 


DISPLAY THE CHARACTER 


0031 


21803C 


00440 




LD 


HL.3C80H 


GET NEXT SCREEN ROW 


0034 


0610 


00450 




LD 


B.10H 


GET 16 VALUE INTO B 






00460 


; ttttttitttttt 


#*#f#*<M««**f#f###f##*#*ffffff###*»fff#f#f 






00470 


: DISPLAY CONTENTS OF ADDRESS CHOSEN 


0036 


1A 


00480 


C0NT02 


LD 


A, (DEI 


GET VALUE AT ADDRESS 


0037 


E6F0 


00490 




AND 


OFOH 


MASK OUT HIGH BITS 


0039 


CDE200 


00500 




CALL 


RRRRS 


OONVERT/OISPLAY ROUTINE 


003C 


1A 


00510 




LD 


A, IDE) 


GET VALUE AT ADDRESS 


0030 


E60F 


00520 




AND 


OFH 


MASK OUT LOW BITS 


003F 


CDD800 


00530 




CALL 


HEXASC 


CONVERT CHAR TO ASCII 


0042 


77 


00540 




LD 


(HLJ ,A 


DISPLAY THE CHARACTER 


0043 


23 


00550 




INC 


HL 


GET NEXT SCREEN POSN. 


0044 


23 


00560 




INC 


HL 


GO ONE PLACE MORE 


0045 


13 


00570 




INC 


DE 


GET NEXT ADDRESS LOCN. 


0046 


10EE 


00580 




DJNZ 


C0NT02 


FULL 16 BYTES DISPLAYED 






005S0 


; tfttttttffttHtttltHIHHtttti 


IftitttitttSttttttttttStt 






00600 


; DISPLAY ASCII 


VALUES TOO 




0048 


0610 


00610 




LD 


B.10H 


GET 18 TIMES IN B REG. 


004A 


46 


00620 




LD 


C,B 


SAVE IT IN C FOR USE 


0048 


18 


00630 




DEC 


DE 


GET NEXT LOWEST ADDRESS 


0040 


10FD 


00640 




DJNZ 


S-1 


DECREMENT BACK TO START 


004E 


41 


00650 




LD 


B,C 


GET 16 TIMES IN B AGAIN 


004F 


21C03C 


00660 




LD 


HL.3CC0H 


GET NEXT LINE OF SCREEN 


0052 


1A 


00670 


BBBA 


LD 


A,(DEJ 


GET CONTENTS OF ADDRESS 


0053 


77 


00680 




LD 


(HL) ,A 


DISPLAY EXACTLY AS IS 


0054 


23 


00690 




INC 


HL 


GET NEXT SCREEN LOCN. 


0055 


23 


00700 




INC 


HL 


GET NEXT AFTER THAT 


0056 


23 


00710 




INC 


HL 


VISUALLY MATCHES HEX 


0057 


13 


00720 




INC 


DE 


GET NEXT ADDRESS TO SEE 


0058 


10FB 


00730 




DJNZ 


BBBA 


DO IT FOR 16 ADDRESSES 


Q05A 


41 


07 40 




LD 


B.C 


GET 16 INTO B AGAIN 


005B 


1B 


00750 




DEC 


DE 


GO BACK TO PREVIOUS 


005C 


10FD 


00760 




DJNZ 


S-1 


AND BACK TO BEGINNING 


005E 


C9 


00770 




RET 




DONE WITH DISPLAY ROUT. 






00780 


; tSSi 


ltttttttttHt**i$*Httttit 


M#ff##ff##ff #*###*»*### 






00790 


; SCAN 


KEYBOARD 


FOR EDIT SEO.UENC 




005F 


CD1300 


00800 


NEXT99 


CALL 


CONTNT 


FIND WHICH KEYS PRESSED 






00810 


; ttttttlttttlttHtttttttttHitl 


tfttttttttttittttttetittt 






00820 


: SCAN 


KEYBOARD 


FOR BREAK. ARROW 




0062 


3A4038 


00830 


EDITOR 


LD 


A,(3840HJ 


GET BREAK, ARROWS ROW 


0065 


FE04 


00B40 




CP 


4 


IS IT BREAK KEY? 


0067 


2006 


00B50 




JR 


NZ, ARROW 


IF NOT TEST FOR ARROW 


0069 


FDE5 


00860 




PUSH 


IY 


ELSE RETRIEVE LINE PTR. 


006B 


E1 


00870 




POP 


HL 


SWITCH BACK INTO HL 


006C 


C3CC06 


DOB 80 




JP 


READY 


BACK TO BASIC READY 


006F 


FE10 


008 SO 


ARROW 


CP 


1DH 


BEGIN ARROW COMPARES 


0071 


2007 


00900 




JR 


NZ.AAAA 


GO IF NOT DOWN ARROW 


0073 


0610 


00910 




LD 


B.10H 


GET B READY WITH 16 


0075 


1B 


00920 




DEC 


DE 


GO BACK IN MEMORY 


0076 


10FD 


00930 




DJNZ 


$-1 


DO IT FOR 16 TIMES 


0078 


1B4B 


00940 




JR 


STNDRD 


DONE NOW: GO OUT 


007A 


FE08 


00950 


AAAA 


CP 


8 


CHECK IF UP ARROW 


007C 


2007 


00960 




JR 


NZ.AAAB 


GO OUT IF NOT UP ARROW 


Q07E 


0610 


00970 




LD 


B.10H 


, GET 16 PLACES READY 


0080 


13 


00980 




INC 


DE 


GET NEXT MEMORY LOCN. 


008t 


10FD 


00990 




DJNZ 


$-1 


, DO IT 16 TIMES IN ALL 


0083 


18 40 


01000 




JR 


STNDRD 


: DONE NOW: GO OUT 


0085 


FE20 


01010 


AAAB 


CP 


20H 


; CHECK IF LEFT ARROW 


0087 


2003 


01020 




JR 


NZ.AAAC 


: GO OUT IF NOT LEFT 


0089 


1B 


01030 




DEC 


DE 


: GET PREVIOUS MEM. LOCN. 


OOBA 


1839 


01040 




JR 


STNDRD 


: DONE NOW; GO OUT 


008C 


FE40 


01050 


AAAC 


CP 


4DH 


: CHECK IF RIGHT ARROW 


008E 


2003 


01060 




JR 


NZ.AAAD 


; GO OUT IF NOT RIGHT 


0090 


13 


01070 




INC 


DE 


• GET NEXT MEMORY LOCN. 


0091 


1832 


01080 




JR 


STNDRD 


: DONE NOW; GO OUT 






01090 


; ## # # 


littniHtlltttltllttllitl 


«#####################*# 






01100 


; GET 


: IFTH LINE OF SCREEN AND D 


[SPLAY CHOSEN EDITING 
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The routine at 1D5A bumps the HL register 
forward, evaluates the byte (finding 8E = RUN), 
then looks for a possible line number to execute. 
Finding a zero means the command ends there, 
and so a simple RUN routine is entered. Here's 
how to try it out once you have it in place: 



SYSTEM 
/20480 



<ENTER> 
<ENTER> 



The BASIC program you had entered earlier 
should now run just as any other BASIC program 
might. So the idea is to make this autorun 
routine the heart of the area that the CLOAD 
might make its way back to. 

Listing 3-(?) presents a machine language 
program which must precede any program to be 
autoexecuted. It follows the rules above by 
taking over control of the computer, placing a 
patch into the keyboard scan in order to 
intercept the terminal CLOAD routine's return 
to BASIC, and directing the computer to the 
usual CLOAD routine. When CLOAD gets back 
into BASIC, it will present a 'READY' and begin 
to scan the keyboard. It will, however, never get 
there. 

Instead, the intercept now patched in place 
will redirect the computer to a short routine also 
present in the keyboard input buffer area. This 
routine restores the original plundered keyboard 
return address, and executes the automatic RUN 
routine. The autoload remnants in the keyboard 
buffer are no longer needed, and will be wiped 
out at the next keyboard input of any kind. 

To use this program, assemble it and save it at 
the beginning of each in a batch of tapes. Use 
these tapes to' CS AVE any programs you wish to 
autoexecute. Whenever you wish to run one of 
these programs, type . . . 



>SYSTEH 
*? AUTO 



<ENTER> 
<ENTER> 



. . . and the program will load, acting as if a 
normal CLOAD were in action, but immediately 
beginning execution of the BASIC routine. 



Machine Language Monitor 

It- can be very frustrating when you need to 
make some quick alterations to memory, or when 
you need to install a short machine language 
program. The options are few: load a 
decimal-to-hex conversion program and enter 
the code; convert the values to hex by hand and 
POKE them in place; write the code into a short 



Undoing NEW 



Continued Listing 



0093 21Q03D 


01110 AAAD 


LD 


HL.3DO0H 


FIFTH LINE ON SCREEN 


0096 365F 


01120 


LD 


(HL) ,5FH 


GET CURSOR CHARACTER 


0098 S3 


01130 


INC 


HL 


NEXT SCREEN LOCATION 


0099 365F 


01140 


LD 


[HL! ,5FH 


GET CURSOR CHARACTER 


009B SB 


01150 


DEC 


HL 


BACK TO FIRST LOCN. 


009C 0609 


01160 


LD 


B,2 


GET 2 TRIES INTO B 


009E OS 


01170 AAAE 


PUSH 


DE 


SAVE MEMORY LOCATION 


009F E5 


011B0 


PUSH 


HL 


SAVE SCREEN LOCATION 


00A0 CD4900 


01190 


CALL 


0049H 


BASIC'S KEYBOARD SCAN 


00A3 E1 


01200 


POP 


HL 


RESTORE SCREEN LOCN. 


00A4 01 


01210 


POP 


DE 


RESTORE MEMORY LOCN. 


00A5 FE47 


01220 


CP 


47 H 


CHECK IF ALPHA HEX 


00A7 30B9 


0123 


JR 


NC, EDITOR 


GO OUT IF NOT ALPHA HEX 


00A9 FE30 


01240 


CP 


3 OH 


CHECK IF NUMERIC HEX 


OOAB 3SB5 


01250 


JR 


C, EDITOR 


OUT IF NOT NUMERIC HEX 


OOAD FE3A 


0126 


CP 


3AH 


CHECK IF OV NUMERIC 


OOAF 3804 


01270 


JR 


C.AAAF 


CHECK NEXT IF IN RANGE 


00B1 FE40 


01280 


CP 


40 H 


CHECK IF OV ALPHAHEX 


00B3 3SAD 


01290 


JR 


C, EDITOR 


OUT IF OV ALPHA HEX 


00B5 77 


01300 AAAF 


LD 


(HLJ ,A 


PLACE CHAR ON SCREEN 


00B6 23 


01310 


INC 


HL 


GET NEXT SCREEN LOCN. 


00B7 10E5 


01320 


OJNZ 


AAAE 


GO GET ANOTHER CHAR. 




01330 ; ttMlttttllltltitttlHtfllttt*ittttftiiitliHttUttiit 




01340 ; CONVERT CHOSEN DATA TO HEX 




00B9 2B 


01350 


DEC 


HL 




OOBA CDCDOO 


01360 


CALL 


ASCHEX 




OOBU 4F 


01370 


LD 


C,A 




OOBE 2B 


013B0 


DEC 


HL 




OOBF CDEOOO 


01390 


CALL 


LLLLS 




0002 81 


01400 
01410 ; 


ADD 


A,C 






01420 ; PUT NEW BYTE 


IN PLACE 




0003 12 


0143 


LD 


(DE),A 




00C4 13 


01440 
01450 i 


INC 


DE 






01460 ; DISPLAY REVISED LINE OF DATA 




00C5 CD1300 


01470 STNDRD 


CALL 


CONTNT 




OOCB C0F400 


01480 


CALL 


DELAY 




OOCB 1895 


01490 
01500 ; 


JR 


EDITOR 






01510 ; ASCII 


TO HEXADECIMAL CONVERSION 


OOCD 7E 


01520 ASCHEX 


LD 


A,[HL) 




OOCE FE40 


0153 


CP 


40H 




OODO 3003 


01540 


JR 


NC.NEXT98 




0002 0630 


01550 


SUB 


3 OH 




0004 09 


0156 


RET 






0005 D637 


01570 NEXT98 


SUB 


37H 




00D7 C9 


01580 
01590 i 


RET 








01600 ; HEXADECIMAL 


TO ASCII CONVERSION 


0008 FEOA 


01610 HEXASC 


CP 


OAH 




OODA 3003 


01620 


JR 


NC.NEXT9B 




OODC C630 


01630 


ADD 


A, SDH 




OODE C9 


01640 


RET 






OODF C637 


01650 NEXT96 


ADD 


A.37H 




00E1 C9 


01660 
01670 ; 


RET 








01680 ; RIGHT 


ROTATES FOR CONVERSIONS 




00E2 OF 


01690 RRRRS 


RRCA 






00E3 OF 


01700 


RRCA 






00E4 OF 


01710 


RRCA 






00E5 OF 


01720 


RRCA 






00E6 C00800 


01730 


CALL 


HEXASC 




DOES 77 


01740 


LD 


(HL) ,A 




00 EA 23 


01750 


INC 


HL 




OOEB C9 


01760 
01770 ; 


RET 








017B0 i LEFT 


ROTATES 


FOR CONVERSION 




OOEC CDODOO 


01790 LLLLS 


CALL 


ASCHEX 




OOEF 07 


01BO0 


RLCA 






OOFO 07 


01810 


RLCA 






00F1 07 


01820 


RLCA 






00F2 07 


01830 


RLCA 






00F3 C9 


01840 
01B50 ; 


RET 








01B60 ; DELA 1 ! 


FOR SCREEN DISPLAYS 




00F4 010020 


0187D DELAY 


LD 


BC.2000H 




00F7 CD6000 


01S80 


CALL 


0060H 




OOFA C9 


018 90 
01900 ; 


RET 








01910 i GET/CONVERT 


ASCII FROM BUFFER 






01920 i TO HEXADECIMAL ADDRESS 




OOFB 0604 


01930 XX99 


LD 


B,4 




OOFD CD7B1D 


01940 SSSS 


CALL 


BYTE 




0100 F5 


01950 


PUSH 


AF 




0101 10FA 


01960 


OJNZ 


SSSS 




0103 F1 


01970 


POP 


AF 




0104 77 


01980 


LD 


(HLJ ,A 




0105 CDCDOO 


01990 


CALL 


ASCHEX 




01 OB 5F 


02000 


LD 


E,A 




0109 F1 


02010 


POP 


AF 




010A 77 


02020 


LD 


(HL! ,A 




010B CDECOO 


02030 


CALL 


LLLLS 




010E B3 


2040 


ADD 


A,E 




01 OF 5F 


02050 


LD 


E,A 




0110 F1 


02D60 


POP 


AF 




0111 77 


02070 


LD 


(HL),A 




0112 CDCDOO 


02080 


CALL 


ASCHEX 




0115 57 


02090 


LD 


D.A 




0116 F1 


02100 


POP 


AF 




0117 77 


02110 


LD 


[HLJ ,A 





BASIC program that does the work. None of 
these are satisfactory. Ideally, a machine 
language monitor is the tool to use. 

But there are disadvantages to the monitors 
currently available. Many are too long, and are 
part of other, lengthier programs. Others overlap 
resident BASIC programs. And none make 
available ASCII representations as well as 
BASIC graphics characters. The short monitor 
presented in this section provides the latter, can 
be executed from BASIC (using the patch table 
presented earlier), and sits wherever in memory 
you would like. 

It consists of a few major sections: The first 
clears the display, presents the requested 
address, displays the hex contents of that 
address and the sixteen following, displays the 
ASCII or graphics values of that address and the 
sixteen following, and presents a cursor for hex 
code entry. The second section searches the 
keyboard for a valid hex character, displays the 
character, waits for another, displays that, and 
advances the address and display. 

The second section also searches the keyboard 
for the arrows, and advances the display (a) one 
place forward on a right arrow; (b) one place back 
on a left arrow; (c) sixteen places forward on an 
up arrow; and (d) sixteen places back on a down 
arrow. Last of all it searches for the (BREAK) 
key, which returns it to BASIC. 

This monitor, as with all the BASIC-transparent 
programs presented in this book, must be 
executed by using the special command patch 
table (see Listing (?)-(?)). The command used in 
this table is /OPEN"NNNN", where NNNN is the 
address to be opened for examination (in hex). 



Listing Continued , . . 



Undoing NEW 

This is a much easier task than the Level II 
manual would have you believe. When the NEW 
command is entered, the program remains in 
place* completely unchanged! The only 
alteration is that the end-of-BASIC-program 
pointer in memory has been changed to the 
beginning of the program. Hence, the computer 
believes that the program has a total length of 
zero. 

But the old end-of-program information is still 
intact elsewhere, and can be found very easily. In 
fact, to restore a program you have actually 
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Continued Listing 



0118 CDECOO 


02120 




CALL LLLLS 


011B 82 




02130 




ADD A,D 


01 1C 57 




02140 




LD D,A 


01 1D eg 




02150 




RET 


06CC 




02160 




END READY 


00000 TOTAL ERRORS 






AAAA 


0D7A 


00950 


00900 




AAAB 


0085 


01010 


00960 




AAAC 


ODBC 


01050 


01020 




AMD 


0093 


01110 


01060 




AAAE 


009E 


01170 


01320 




AAAF 


00B5 


01300 


01270 




ARROW 


006F 


00890 


00850 




ASCHEX 


OOCD 


01520 


01360 


01790 01990 020B0 


BBBA 


0052 


00670 


00730 




BYTE 


1D7B 


0U140 


00180 


01940 


C0NT02 


0036 


004S0 


00580 




CONTNT 


0013 


002B0 


00800 


01470 


DELAY 


00F4 


01870 


01480 




EDITOR 


0062 


00830 


01230 


01250 01290 01430 


HEXASC 


00D8 


01610 


00340 


00420 00530 01730 


LLLLS 


ODEC 


01790 


01390 


02030 02120 


NEXTS6 


OODF 


01650 


01620 




NEXT9B 


00D5 


01570 


01540 




NEXT99 


005F 


00800 


00250 




OPENER 


0000 


00180 






READY 


06C0 


00130 


008B0 


02160 


RRRRS 


00E2 


01690 


00310 


00390 00500 


SSSS 


OOFD 


01940 


01960 




STNDRD 


0005 


01470 


00940 


01000 01040 01080 


SYNERR 


1997 


00150 


00200 




XX99 


OOFB 


01930 


00230 





wiped out, you need to invoke a few ROM 
routines and restore the beginning-of-program 
pointer. 

Although variables are cleared in this process, 
the program is totally restored. If you wish to 
make this a part of a transparent operating system 
using the interpreter patch presented earlier in 
this chapter, Listing 3-(?) presents a complete 
routine. Enter /NEW, and the lost program 
reappears. 

One warning is in order: if before restoring the 
program you cause a ?SN ERROR, the computer 
will jumble up the first part of the program, mess 
around with some other memory pointers, and 
the program will really be lost. 



0000 ED5BA440 
0004 3EFF 

0006 12 

0007 CDFC1A 

000A 23 
OODB 22F840 
000E ED7BE840 
0012 CDC901 
0015 CD611B 
0018 C3CC06 



0000 

00000 TOTAL E 
RENEW 0000 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
00320 
00330 
00340 
00350 
RRORS 
00220 



tUttttttHttttttttlfttttttttttft 

ONLY A SHORT ROUTINE IS NECESSARY 
A BASIC PROGRAM WAS BEFORE ITS PO 
BEGINNING OF PROGRAM POINTER MUST 
NUMBERS RUN THOUGH, THE END OF PR 
THE STACK POINTER RESET, THE SCRE 
CLEAR (RESET VARIABLES AND PROGRA 
»«################«########### 
NOTE THAT THIS ROUTINE IS ALSO CA 
THE FORMAT /NEW. THE CUSTOM INTE; 

tmttttttttttttttttttttttttttt 



tttttttfltttttffftStt 

TO DETERMINE WHERE 
INTERS WERE RESET. THE 

BE RESET, THE LINE 
OGRAM POINTER RESET, 
EN CLEARED, AND THE 
M CONDITIONS! EXECUTED 

tttttttStfiittittftSl 
LLED FROM BASIC USING 
RPRETER IS EMPLOYED. 
tttftttttttlttttttUtt 



RENEW 



LD 
LD 
LD 
CALL 

INC 

LD 

LD 

CALL 

CALL 

JP 

ttttttt 

END 



DE,t40A4HJ 
A.OFFH 
(DEJ ,A 
1AFCH 

HL 

(40F9HJ ,HL 

SP.UOEBH) 

D1C9H 

1B61H 

06CCH 



GET START OF PRGRM PTR 
GET FF RESETTING CODE 
PLACE AT PROGRAM START 
GO THRU ALL LINES TILL 
END OF PRGRM 00 FOUND 
HL MOVED JUST PAST PRGM 
SIMPLE VARIABLE POINTER 
RESET STACK TO NORMAL 
CLEAR THE SCREEN NOW 
CLEAR ALL THE POINTERS 
BACK TO BASIC "REAOY" 



tUttfttlttttttttttttltlt ««#«#«## 



Resetting MEMORY SIZE? 

The size of BASIC memory available can also 
be changed from BASIC itself, because it too is 
simply stored in a two-byte pointer in the RAM 
patch area. New values may be POKEd into 
place, so long as they meet two conditions: 

1. The new value must be within the range 
of actual memory available. 

2. It must not dip below the top of an 
existing BASIC program already in memory. 

3. If no program is in memory, it must not 
dip below address 4414. 



Here's how to do it. Convert the desired new 
memory size to split decimal with this formula: 



5000 21003C 
5003 11013C 
5006 01FF03 
5009 3620 
500B EDBO 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
003 20 
00330 
00340 
00350 



tttttttttttittttttttttttttttttttttttttitnttntttitttti 

RAM CHECKING PROGRAM - FIRST VERSION WITHOUT DISPLAY - 
EXHAUSTIVELY CHECKS EACH TRIO OF RAM LOCATIONS WITHOUT 
DISPLAYING CURRENT ADDRESS; BAD ADDRESSES ONLY SHOWN. 
itHittHttHttittttttttttttttttHttitHttttltHttUttt 

NOTE THAT THIS PROGRAM IS * SELF-RELOCATING » AND MUST 
BE ASSEMBLED AT THE ORIGIN ADDRESS SPECIFIED BELOW. 
ttH*ttttttttt*tH*ttittlt*ttt§tttt*ttlttttttttfttttttt 



ORG 



5000H 



DO NOT CHANGE ORIGIN 1 



ttttlttltttltttttttttttUttttttttttttttttttttttiltttttt 

SUBROUTINE TO CLEAR THE SCREEN WITH NORMAL SPACES 
ttttttlttttttttllttttttttttttttttttttttltHltltHHtHt 

BEGINNING OF VIDEO 
DESTINATION OF SPACE 
SPACES ON SCREEN 
DISPLAY BLANK SPACE 
CLEAR THE SCREEN 

tttttltttttttltttlttttttttttttittftt§tttttttltttntfttt 

SET UP MIDDLE OF PROGRAM POINTER, DISPLAY STAR TO SHOW 
PROGRAM IS WORKING. SET UP THE STACK POINTER IN RELA- 
TIONSHIP TO THE IX REGISTER, AND SPECIFY START OF TEST 
ttltttttttttHttittttttttttfftttttttttftttttttttttlUtt 



LD 


HL.3C00H 


LD 


DE.3CD1H 


LD 


BC.03FFH 


LD 


(HL) ,20,1 


LDIR 
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X = NNNNN 


<ENTEH> 


Y = FIX (X/256) 


<ENTER> 


Z = X - Y * 256 


<EHTER> 


PRINT Z,Y 


<ENTER> 



The value of Z is the least significant byte of 
the new memory size, Y is the most significant 
byte. Now: 



POKE 1B5B1.Z : POKE 16562, Y : CLEAR50 

The new memory size has been set, and 50 
bytes are cleared for string space, as usual. If you 
haven't followed the rules about legitimate 
memory sizes, expect a fast system crash. 



Chapter 3 



Peek That Keyboard 



Continued Listing 






00360 


500D 


DD21B050 


00370 


5D11 


3AFE3F 


003B0 


5014 


EEOA 


00390 


5016 


32FE3F 


00400 


5D19 


DDF9 


00410 


501 B 


067F 


00420 


5010 


33 


00430 


501 E 


10FD 


00440 


5020 


210060 


00450 
00460 
00470 
00480 
00490 
00500 
00510 
00520 
00530 


SO 23 


AF 


00540 


5024 


77 


00550 


5025 


4F 


00560 


5026 


F5 


00570 


5027 


79 


005B0 


5026 


77 


00590 


5029 


23 


00600 


502A 


7C 


00610 


5026 


FEBO 


00620 
00630 
00640 
00650 


5020 


2B3 


00660 


502F 


E5~ 


00670 


5030 


ODES 


00680 


5032 


E1 


006 90 


5033 


BC 


00700 


5034 


2B2S 


00710 


5036 


E1 


00720 


5037 


F1 


00730 


5036 


77 


007 40 


5039 


SB 


007SO 


503A 


28 


00760 


503B 


77 


00770 


503C 


47 


07 BO 


5030 


7E 


007 90 


503E 


B6 


00800 


503F 


280 5 


00810 


5041 


161B 


00B20 


5043 


05 


O0B30 


5044 


1B1B 


008 40 


5046 


23 


00B50 


5047 


23 


00B60 


504B 


7E 


O0B70 


5049 


BB 


00880 


504A 


2B05 


00B9O 


504C 


1610 


00900 


504E 


OS 


00910 


504F 


1810 


00920 


5051 


2B- 


00930 


5052 


34 


00940 


5053 


OC 


00950 


5054 


7E 


00960 


5055 


47 


00970 


5056 


FEOO 


OOSBO 


5056 


20CC 


009 90 


505A 


23 


01000 


505B 


OEOO 


01010 


505D 


18C7 


01020 


505F 


1864 


01030 
01040 
01050 
01060 
01070 
01080 
01090 
01100 
01110 


5061 


7C 


01120 


5062 


E6F0 


01130 


5064 


OF 


01140 


50S5 


OF 


01150 


5066 


OF 


01160 


5067 


OF 


01170 


506B 


1622 


01180 


506A 


1822 


01190 


506C 


70 


01200 


506D 


E6 0F 


01210 


506F 


161B 


01220 


5071 


1B1B 


0123 


5073 


70 


01240 


5074 


E6F0 


01250 


5076 


OF 


0126 


5077 


OF 


01270 


507 B 


OF 


01280 


5079 


OF 


01290 


507A 


1610 


01300 


507C 


1810 


01310 


507E 


70- 


01320 


507F 


E60F 


01330 


5081 


1609 


01340 


50BS 


1B09 


01350 


5085 


01 


01360 


5086 


3ED3 


01370 



LD 


IX,5080H 


LD 


A, (3FFEH) 


XOR 


OAH 


LD 


(3FFEH) ,A 


LO 


SP.IX 


LD 


B.7FH 


INC 


SP 


DJNZ 


S-1 


LD 


HL.6000H 



MIDDLE OF TEST PROGRAM 
BOTTOM RIGHT OF SCREEN 
ALTERNATE SPACE & STAR 
DISPLAY IT ON SCREEN 
START STACK POINTER 
NUMBER OF MOVES FOR SP 
SP = SP + 1 
DO IT 127 TIMES 
BEGINNING OF TEST AREA 



################# »###«##*#######*### ###########*###### 
TEST BEGINS WITH THE VALUE OF ZERO, AND PROCEEDS TO 
VALUE FF. EACH VALUE IS WRITTEN IN TURN TO EACH OF A 
TRIO OF MEMORY LOCATIONS IN ORDER TO DETERMINE THEIR 
EFFECT ON EACH OTHER AS VALID ELECTRONIC STORAGE CELLS. 
HHftHttttUttHtMHHftittttttttitttttttttittttttt 



CLEAR ACCUMULATOR 
PLACE VALUE IN MEMORY 
PLACE VALUE IN C 
SAVE VALUE IN ACCUM. 
GET VALUE FROM C 
PLACE VALUE IN MEMORY 
INCREMENT TO NEXT MEM 
GET MSB OF ADDRESS 
IS MEM AT 8000 YET? 
NOTE THAT THE VALUE 
ABOVE IS FOR 16K 
CO FOR 32K, {otT TOR 4 8K 
IF SO, THEN 



XOR 


A 


LD 


CHL) ,A 


LD 


C.A 


PUSH 


AF 


LD 


A.C 


LD 


(HL) ,A 


INC 


HL 


LD 


A.JU-— 




-jaBTJffr____ 


CO 


<2><2>M 


JR 


Z.S+32H 


PUSH 


HL 


PUSH 


IX 


POP 


HL 


CP 


H 


JR 


Z.S+2BH 


POP 


HL 


POP 


AF 


LD 


(HL) ,A 


DEC 


HL 


DEC 


HL 


LD 


(HLJ .A 


LD 


8, A 


LD 


A,[HL) 


CP 


B 


JR 


Z.S+7 


LD 


D.1BH 


PUSH 


DE 


JR 


5+1 OH 


INC 


HL 


INC 


HL 


LD 


A.tHL) 


CP 


B 


JR 


Z,$+7 


LD 


0,1 OH 


PUSH 


DE 


JR 


S+12H 


DEC 


HL 


INC 


(HL) 


INC 


C 


LD 


A.tHL) 


LD 


B,A 


CP 


00 


JR 


NZ.S-32H 


INC 


HL 


LD 


C,0 


JR 


$-37 H 


JR 


S+66H 



ELOCATE 
SA'VE MEMORY VALUE 
SAVE MIDDLE OF PROGRAM 
GET POSITION INTO HL 
CHECK AGAINST BO VALUE 
RELOCATE IF DONE 
RESTORE ORIGINAL VALUE 
RESTORE ORIGINAL TEST 
PUT VALUE INTO MEMORY 
BACK TO ORIGINAL LOC"' N 
BACK TO ONE BEFORE IT 
PUT VALUE INTO MEMORY 
SAVE VALUE IN B REG. 
GET VALUE AT LOC'N HL 
CHECK AGAINST B VALUE 
GO ON IF IT CHECKS OKAY 
GET VALUE OF REL. SUB. 
SAVE VALUE ON STACK 
JUMP TO SUBROUTINE 
GET ORIGINAL TEST POS'N 
GO ONE BEYOND IT 
GET VALUE AT THAT POS'N 
CHECK AGAINST B REG. 
GO ON IF MEMORY OKAY 
GET JUMP FOR REL. SUB. 
SAVE VALUE ON STACK 
JUMP TO SUBROUTINE 
BACK TD ORIGINAL POS'N 
INCREMENT VALUE IN MEM 
INCREMENT TEST VALUE 
GET VALUE IN MEMORY 
SAVE VALUE IN B REG. 
CHECK IF 256 BYTES DONE 
LOOP BACK ANO CONTINUE 
GET NEXT MEMORY VALUE 
RESET TEST VALUE TO 
LOOP BACK FOR NEXT TEST 
REL. SUB. STEPPING STONE 



SUBROUTINE BELOW IS ENTERED WHEN A BAD MEMORY LOCATION 
HAS BEEN DETERMINED. IT CONVERTS HEX VALUES TO ASCII 
AND DISPLAYS THEM ON THE SCREEN. NOTE THE RELATIVE 
SUBROUTINE ENTRY AND EXIT METHOD USING THE D REGISTER. 



GET VALUE FROM H REG. 
MASK OFF LOW BITS 
ROTATE RIGHT FOR CONV. 

SOME MORE 

AND SOME MORE 

UNTIL IT'S DONE. 

GET VALUE FOR REL. SUB. 
AND JUMP TO SUBROUTINE 
GET VALUE FROM H REG. 
MASK OUT HIGH BITS 
GET VALUE FOR REL. SUB. 
AND JUMP TO SUBROUTINE 
GET VALUE FROM L. REG. 
MASK OUT LOW BITS 
ROTATE FOR CONVERSION 

SOME MORE 

SOME MORE 

AND IT'S DONE. 

GET VALUE FOR REL. SUB. 
AND JUMP TO SUBROUTINE 
GET VALUE FROM L REG. 
MASK OUT HIGH BITS 
GET VALUE FOR REL. SUB. 
AND JUMP TO SUBROUTINE 
RESTORE VALUE TO DE 
G ET RETURN POS 'N VALUE 

Listing Continued , , , 



LD 


A,H 


AND 


OFOH 


RRCA 




RRCA 




RRCA 




RRCA 




LD 


D.22H 


JR 


S+24H 


LD 


A.H 


AND 


OFH 


LD 


0,1 BH 


JR 


S+1DH 


LD 


A,L 


AND 


OFOH 


RRCA 




RRCA 




RRCA 




RRCA 




LD 


D.10H 


JR 


S+12H 


LD 


A,L 


AND 


OFH 


LD 


0,9 


JR 


$+OBH 


POP 


DE 


LD 


A.0D3H 



Peek that Keyboard 

One of the handiest functions for fast-running, 
convenient BASIC programs is the INKEY$ 
command. This allows the latest keystroke to be 
transferred to a program variable, where it can 
then be evaluated. 

For action games, BASIC word processors and 
other speed-conscious programs, INKEY$ can 
be too long because it requires considerable 
evaluation and juggling of memory space. There 
is a faster way, and it involves examining the 
keyboard's memory contents directly. Below is 
the keyboard matrix: 




You can see that various memory locations 
refer to various rows of keys. Depending on the 
key pressed, different values will be discovered 
by PEEKing. For example, A=PEEK(14400) 
returns a value of 1 if ENTER is pressed, and a 
value of 2 if CLEAR is pressed, 4 if BREAK is 
pressed, 8 for down arrow, 16 for up arrow, 32 for 
left arrow, 64 for right arrow, and 128 for a space. 
If only a few keys are being sought - perhaps the 
arrow in an action game - a very tight loop can be 
constructed that is many times faster than 
INKEY$: 



10 A = PEEK(14400) :/l¥ A=OJTHEN 10 
20 IF A=B THEN 100 /<fpT^16 THEN 2&0 
30 IF A=3E THEN 3QQ\j \f A=B4-4HEtT400 




40 GOTO 10(^-. 



For top-speed operation, this should all appear 
on one line; try it in comparison with testing for 
CHR$(8) or CHR$(9), etc., etc., to determine the 
arrows. 
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Con 

5088 


tinued 

92 


Listing 

01380 


5089 


007700 


01390 


S08C 


1BFF 


01400 


508E 


05 


01 41 U 


5Q8F 


F5 


01420 


5030 


11003C 


0143 


5093 


1A 


01440 


5094 


FE20 


01450 


5096 


2803 


01460 


5098 


13 


01470 


5099 


18F8 


01480 


509B 


7B 


01490 


5090 


FE04 


01500 


509E 


200A 


01510 


50A0 


3E20 


01520 


50A2 


1B 


0153 


50A3 


12 


01540 


50A4 


1B 


01550 


50A5 


12 


01560 


50A6 


1B 


01570 


50A7 


12 


01580 


50A8 


1B 


01590 


5DA9 


12 


01600 


5 0AA 


F1 


01610 


50AB 


FEOA 


01620 


50AD 


3004 


01630 


50AF 


C630 


01640 


50B1 


1802 


01650 


50B3 


C637 


01660 


50B5 


12 


01670 
01680 
01690 
01700 
01710 
01720 


5086 


C5 


01730 


50B7 


06FF 


01740 


50B9 


10FE 


01750 


50BB 


01 


01760 


50BC 


01 


01770 


50BD 


3EC9 


01780 


50BF 


92 


01790 


50C0 


0D7744 


01800 


50C3 


18FF 


01810 
01B20 
01B3 
01840 
01850 
01860 
01870 
01880 
01B90 
01900 


50C5 


DDE5 


01910 


50C7 


DDE5 


01920 


5009 


E1 


01930 


50CA 


D1 


01940 


50CB 


7A 


01950 


50CC 


EE20 


01960 


500E 


57 


01970 


50CF 


05 


01980 


5000 


0680 


01990 


5002 


28 


02000 


5003 


1B 


02010 


5004 


10FC 


02020 


5006 


01FF00 


02030 


5009 


EDBO 


02040 


50DB 


DDE1 


02050 


5000 


3E20 


02060 


50DF 


DDAEA2 


207 


50E2 


DD77A2 


020B0 


50E5 


3EF0 


02090 
02100 
02110 
02120 


50E7 


DDAEAC 


02130 


50EA 


DD77AC 


02140 


50ED 


0DE5 


02150 


50EF 


E1 


02160 


50F0 


2E11 


02170 


50F2 


E9 


02180 
02190 
02200 


5000 




02210 


00000 TOTAL 


ERRORS 



SUBTRACT RETURN DIFF, 
AND MAKE JR OPERAND 
IRRELEVANT OPERAND 
SAVE VALUE ON STACK 
SAVE VALUE ON STACK 
GET TOP LEFT OF SCREEN 
GET VALUE ON SCREEN 
IS IT A SPACE NOW? 
IF SO, GO AHEAD SOME 
INCREMENT SCREEN POS'N 
AND GO AHEAD PAST TEST 
GET VALUE OF SCREEN 
IS IT 4 POS'NS OVER? 
IF NOT, GO ON AHEAD 
IF SO GET A SPACE READY 

GO BACK SOME 

AND FILL WITH A SPACE 

AND BACK SOME MORE 

AND INSERT ANOTHER ONE 

AND BACK A BIT MORE 

AND STASH ANOTHER SPACE 
AND BACK ONE MORE TIME 
AND STUFF A SPACE THERE 

RESTORE VALUE TO AF 
IS VALUE LESS THAN 10? 
IF LESSER, THEN JUMP 
CONVERT HEX TO ASCII 
AND GO ON PAST THE REST 
CONVERT HEX TO ASCII 
AND STASH ON THE SCREEN 



tH*t*ttttttttHtHtt»tttt»tttttttttttttitt*ttttt»itttl 
SHORT ROUTINE BELOW USED AS DELAY AFTER LOC'N DISPLAY. 

HHItHUiltltttHtltttttlltttlUMttttitltHltlHIttl 



SUB 


D 


LD 


(IX+ODH! ,A 


JR 


S+1 


HUSH 


DE 


PUSH 


AF 


LD 


DE.3C00H 


LD 


A.tDE] 


DP 


20H 


JR 


Z.S+5 


INC 


DE 


JR 


S-6 


LD 


A.E 


CP 


04 


JR 


NZ.S+OCH 


LD 


A.20H 


DEC 


DE 


LD 


(DE) ,A 


DEC 


DE 


LD 


(DE) ,A 


DEC 


DE 


LD 


(DE) ,A 


DEC 


DE 


LD 


(DE) ,A 


POP 


AF 


CP 


OAH 


JR 


NC,$+6 


ADD 


A.30H 


JR 


S+4 


ADD 


A.37H 


LD 


(DE) ,A 



PUSH 


BC 


LD 


B.OFFH 


DJNZ 


$-0 


POP 


BC 


POP 


DE 


LD 


A.0C9H 


SUB 


D 


LD 


(IX+44H) ,A 


JR 


S+1 



SAVE VALUE IN BC REG 
GET DELAY VALUE 
AND DELAY JUST A LITT 
RESTORE BC VALUE 
RESTORE DE VALUE 
GET VALUE TO RETURN 
SUBTRACT JUMP OFFSET 
PLACE AS JR OPERAND 
IRRELEVANT OPERAND 



PROGRAM RELOCATION ROUTINE. HL AND DE REGISTERS ARE 
LOADED FROM THE IX REGISTER, AND MODIFIED BY EXCLUSIVE- 
ORING WITH A KNOWN VALUE IN A. THUS, A NEW PROGRAM 
BEGINNING CAN BE DETERMINED. INTERNAL TEST POSITIONS 
CAN BE MODIFIED. AND THE IX AND SP POINTERS RESET. 

SAVE PROGRAM POSITION 
SAVE PROGRAM POSITION 
TRANSFER TO HL REG. 
TRANSFER TO DE REG. 
GET VALUE FROM D REG. 
TRANSFER TO HIGH MEM. 
PUT BACK IN D REG. 
AND STASH ON STACK 
DEC. TO PROGRAM START 
AND BEGIN DECREMENTING 
FOR BOTH THE REGISTERS 
UNTIL IT'S ALL DONE 
AND GET READY TRANSFER 
AND THEN DO IT! 
RESTORE NEW VALUE 
VALUE TO MOD. ADDRESSES 
MOUIFY IX+A2 ADDRESS 
AND STORE IT IN PLACE 
VALUE TO MOD. ADDRESSES 
CHANGE OPERAND ABOVE TD 
"" FflR 3PK MFM TFRT AHn 
TQ- yO FOR 4BK MEM TES TES 

MODIFY IX+AC ADDRESS! 

AND STORE IT IN PLACE 
STORE THE PROGRAM PTR . 
AND TRANSFER IT TO HL 
SET LSB OF HL REGISTER 
JUMP TO PROGRAM START I 



PUSH 


IX 


PUSH 


IX 


POP 


HL 


POP 


DE 


LD 


A.D 


XOR 


2DH 


LD 


D,A 


PUSH 


DE 


LD 


B.BOH 


DEC 


HL 


DEC 


DE 


DJNZ 


$-2 


LD 


BC.OOFFH 


LDIR 




POP 


IX 


LD 


A,20H 


XOH 


(IX+0A2H) 


LD 


(IX+QA2H) ,A 


LD 


A P aEfiH--jj^' 


_o 


A ,l-a>^ 


XOR 


(IX+OACH) 


LD 


(IX+OACH) .A 


PUSH 


IX 


POP 


HL 


LD 


L.11H 


JP 


(HL) 



ttutwitinttittttiiitttHHtnttttttt 

END 50D0H 



ItttttHt 



There is yet another use for this PEEK 
function. As noted in Chapter 2, location 387F 
reveals if any key is pressed at all. This can be 
used in a BASIC text editor, for example, and is 
much faster than INKEY$ to check for 
keypressing: 

10 A = PEEK(14463) : IF A=0 THEN 1D 

This is one of the fastest keystroke-detectors 
in BASIC, and from there a group of PEEKs 
could be done, checking the most-used rows of 
characters first. It's both a matter of taste and 
programming skill whether INKEY$ or PEEK is 
used for keyboard input, but in some situations 
(such as testing for carriage returns and other 
control codes), PEEK is the winner. 



KEYBOARD PEEK POSITIONS 



DATA: 

ADDRESS: 

14337 

14338 

14340 

14344 

14352 

14368 

14400 

14464 



H 

P 

X 



8 ( 

ENT 

SHIFT 



A 

I 

a 

Y 
1 I 
9 ] 
CLR 



16 

D 

L 
T 



3 # 4 $ 



32 

E 
H 
U 

5 % 



64 

F 
N 
V 

6 & 
. > 



128 

G 

W 



BKR UPAR DNAR LFTAR RTAR SPACE 



Figure 3-(?) is a chart of all the characters and 
their respective PEEK positions and data 
returned. Remember, when more than one key is 
depressed at a time, the row of the data at that 
address is returned. For example, if PEEK 
(14400) returns 129, then both ENTER and 
SPACE are being held down. This is significant 
because INKEY$ returns only the last character 
pressed, and there is no real way of getting to 
multiple characters. Try this: 



10 A = PEEK (14400) 

20 IF A = 129 THEN 100 

30 PRINT "PRESS ENTER AND CLEAR" 

40 GOTO 10 

100 PRINT"DONEI" 



Simple as this may appear, it offers an 'out' for 
programs that need special, unusual input for 
some functions. It can be used as the sort of 
double-interlock protection switch found on 
industrial machinery to keep both hands out of 
blades and moving parts. 

Furthermore, when the keyboard is PEEKed, 
the values returned can be changed and mutated 
at will - for example, a BASIC letter-writer could 
have two easily written routines to make the 
keyboard the standard 'QWERTY' type or 
changing it to the faster Dvorak type. Of course, 
even with PEEK statements, BASIC is not likely 
to keep up with that sort of speed typing! 
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Make-'Em-Sweat Memory Test 

Many memory tests are available for testing 
the dynamic memory in the TRS-80 and 
expansion interface, including the simple test 
done by the computer itself on power-up (see 
Supplement to Chapter 1). Most have a 
significant disadvantage: they are software tests 
rather than electrical tests. Certainly, since 
memory involves operating software, a software 
test seems to be a logical solution. 

On the other hand, memories are electronic 
devices, run by electricity and influenced in their 
failings by electrical and physical forces. Barring 
removing each memory and running 
sophisticated electrical tests on it, then, there is 
only one serious memory test option: test each 
bit in combination with each and every other bit 
in the device. Unfortunately, that is impractical, 
since there are 393,216 bits in a 48K system, and 
testing every one would result in over 
150,000,000,000 separate tests - a task that 
would take nearly a solid month running at the 
TRS-80's 1.77 MHz clock rate! 

The remaining option, then, is to make 
reasonable electrical tests that exercise the 
neighboring bits in a memory chip, and read and 
write to them about as fast as the TRS-80 is likely 
to do it in real time. The process I have chosen is 
twentyfold: 



10. Change the surrounding bits from zeros to 
ones. 

11. Read the stored value and check its 
accuracy. 

12. Change the surrounding bits from ones to 
zeros. 

13. Read the stored value and check its 
accuracy. 

14. Change the surrounding bits from zeros to 
ones. 

15. Write the value to memory again. 

16. Read the stored value and check its 
accuracy. 

17. Change the surrounding bits from ones to 
zeros. 

18. Write the value to memory again. 

19. Read the stored value and check its 
accuracy. 



1. Write a value to memory. 

2. Read the stored value and check its 
accuracy. 

3. Change the surrounding bits from zeros to 
ones. 

4. Change the surrounding bits from ones to 
zeros. 

5. Read the stored value and check its 
accuracy. 

6. Change the surrounding bits from zeros to 
ones. 



20. Increment the value to be written and 
repeat. 



This process is repeated 256 times, writing 
values from 00 to FF, and producing the electrical 
switches noted above. The program then moves 
itself to another area of memory, and checks the 
area in which it was just residing. 

The entire memory test is still very 
time-consuming, since the address under test is 
displayed while the process is continuing. 



7. Change the surrounding bits from ones to 



zeros. 



8. Write the value to memory again. 

9. Read the stored value and check its 
accuracy. 



In the program presented in Listing 3-(?), the 
test displays the memory location under test; any 
failed memory location is displayed on the 
screen, along with the bits which have failed. The 
test is presented in a 16K version with changes 
for 32K and 48K systems. 
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Cassette I/O 

One of the most maligned aspects of the 
TRS-80 is its cassette loading procedure. 
Interestingly, it is a lengthy and skillfully 
designed piece of coding, a victim of a 
combination of poor hardware (an inexpensive 
cassette recorder), the inclination personal 
computer owners have to purchase the least 
expensive tapes they can find, and the lack of 
foresight on the part of the engineers designing 
the routines. But there's no question that with a 
good tape recorder and reasonable tape, it works 
well. Here's how. 



The routine to read and accept serial 
information is fairly convoluted, collapsed to 
about a dozen major subroutine CALLs. We will 
start with the SYSTEM command; since BASIC 
programs have other bytes to juggle (looking for 
out-of-memory errors, etc.), we won't tackle its 
major routines. 



The SYSTEM module 

The SYSTEM command is evaluated by the 
BASIC interpreter, and its control routine is 
entered at 02B2. If you don't want to know how 
this command gets to work, then skip right to the 
tape loading routine two paragraphs below. An 
initial CALL is executed to DOS link 41E2, which 
in Level II merely executes a RETurn. The stack 
is set up at 4288, and another CALL executed to 
20FE, which checks the DOS link at 41C1, picks 
up the 'device type' - video, tape, or printer - 
(video at this time), displays a carriage return, 
checks and saves port FF status (32 or 64 
character mode and cassette state), clears the 
accumulator, and returns. This is preparatory 
housekeeping. 

The accumulator is set up with a star, it is 
displayed (with more housekeeping), and the 
INPUT routine is CALLed from location 1BB3. 
This is the same routine used for INPUT 
statements, and it displays a question mark, 
evaluates the input line, discards everything 
after certain punctuation, and returns the 
evaluated line to the CALLing program. If a 
BREAK is discovered, the program returns to 
READY. Spaces, line feeds, tabs, etc., are 
cleaned out, and a syntax error is declared if no 
alphanumeric characters are found. If a slash (/) 
is found, the SYSTEM program jumps past its 
loading routines, picks up the start address from 
40DF (more about that later), cleans out blanks 



again, and evaluates the string after the slash as 
an interger (a CALL to 1E5A). The whole 
business starts over if a non-numeric string is 
found. If, at last, the program does discover that 
a number was input, the SYSTEM module is 
executed from the starting address stored at 
40DF. 



Build-a-Byte 

The first major loading call is to 0293, which 
searches for a synchronization byte. Since this 
will eventually call the 'build-a-byte' routine, 
let's move there first. It begins at 0241; BC and 
AF registers are saved. Then: 



0343 


DB FF 


IN 


A,(FF) 


0246 


17 


RLA 




D248 


30 FB 


JR 


NC.0243 


0248 


06 41 


LD 


B,41 


024A 


10 FE 


DJNZ 


024A 



Port FF is checked repeatedly by inputting the 
value to the accumulator and rotating that value 
into the carry flag. If no carry is found - i.e., no 
'one' bit has yet triggered port FF - the program 
loops back to 0243. Once a bit is found, the B 
register is loading with 41, and a 'waste time' loop 
is executed at 024A (a total of just under 500 
microseconds). A CALL is then executed to 
021E. Let's have a look at that: 



021E 


21 00 FF 


LD 


HL.FF00 


0221 


3A 3D 40 


LD 


A,(403D] 


0224 


A4 


AND 


H 


0225 


B5 


OR 


L 


0226 


D3 FF 


OUT 


(FF) ,A 


0228 


32 30 40 


LD 


[403D1.A 


022B 


C9 


RET 





This curious subroutine seems to stumble 
through checking port FF for its video state, then 
resetting the OUTSIG flip-flop (see the 
Technical Reference Handbook for details on 
this circuitry). Isn't a byte ANDed with FF and 
ORed with 00 merely itself? True enough, but 
since this is also called as a subroutine entering at 
0221, with a different value for HL, the complex 
AND/OR strategy makes sense. 

So at this point we have picked up a bit from 
tape, delayed, and reset the flip-flop, readying it 
for the next bit to trigger it. Another delay loop 
follows (over 850 microseconds), and a byte is 
input to A from port FF: 



02S3 


DB FF 


IN 


A,(FF) 


0255 


47 


LD 


B,A 


0256 


F1 


POP 


AF 


0257 


CB 10 


RL 


B 


0259 


17 


RLA 




025A 


F5 


PUSH 


AF 
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The input byte is saved in the B register, and 
the previously saved value of A is restored from 
the stack. Here is a wonderful piece of 
serial-to-parallel conversion - a sort of software 
shift register. Bit 7 of port FF was input to A and 
saved in B, and is then rotated left into the carry 
flag. Then the accumulator is rotated left, 
bringing the state of the carry flag into bit of A. 
The accumulator is then saved once more on the 
stack. Another CALL to 021E resets the port FF 
flip-flop, both registers are restored, and the 
subroutine returns to the calling program. 

You'll notice that at this point we have only 
one bit saved in the accumulator. An 
eight-iteration loop would be necessary to create 
a whole byte . . . and it will be done. But for the 
moment let's see how this routine is used in the 
initial syncing program, which we were about to 
enter at 0293. 

The routine's first action is to CALL 01FE. 
This is a detailed routine to determine the drive 
number and other parts of the syntax, the state of 
port FF (again), select the drive and get it 
moving. Examining the code will show that it 
also uses the routine entered at 0221, but with a 
value of FF04 in HL; this routine won't be 
covered here, but it is worth looking at. 

The find-sync-byte routine thus turns on the 
tape, saves the HL register, clears the 
accumulator, and calls the 'build-a-byte' routine 
at 0241. Since this is the synchronization process, 
no loop value is specified: 



0297 AF 

D238 CD 41 02 

029B FE A5 

029D 20 FB 



XQR A 

CALL 0241 

CP A5 

JR NZ.02S8 



It continually seeks bits, endlessly rotating the 
accumulator until it assembles a serial stream 
which matches A5 (i.e., binary 10100101 - nice 
and symmetrical). This routine is so accurate, in 
fact, that whenever tape motor start-up is not a 
consideration, the leader consisting of zero bytes 
would be unnecessary. The leading '1' of A5 
serves as a kind of serial 'start bit' - and the 
routine at 0241 handles it from there. 

Any kind of match to sync byte A5 might be 
found, tough, since the serial stream coming in 
from the tape does not distinguish start and end 
of byte. For example, the byte pattern DD 28 
also contains an A5 embedded in it. As a serial 
stream, DD 28 is 

1101110100101000 
10100101 



- with the A5 appearing at the junction of DD 
and 28. So once the matching A5 is found, a 
return is executed to the main SYSTEM loading 
module. That module then CALLs a subroutine 
at 0235, which is a gussied-up bit reader. BC and 
HL are saved, then: 



0237 06 08 

023S CD 41 02 
023C 10 FB 



LD B,08 

CALL 0241 

DJNZ 0239 



There's the byte read . . . read a bit with eight 
iterations. HL and BC registers are restored, and 
the subroutine returns to the main program. 



Loading the Code 

The SYSTEM module now compares the byte 
it created with the value 55, the code assigned to 
machine language programs. It loops until it 
finds that code, then proceeds: 



02D8 


0B 06 


LD 


B,6 


02DA 


7E 


LD 


A.IHL) 


02DB 


B7 


OR 


A 


D2DC 


28 09 


JR 


Z,02E6 


02DE 


CD 36 02 


CALL 


0235 


02E1 


BE 


CP 


(HL) 


02E2 


20 ED 


JR 


NZ.02C1 



Above, the B register is loaded with the 
number of characters to be found in the 
SYSTEM program's name. The accumulator is 
set up with the first character of the name as 
entered on the *? command line. The 
accumulator is tested for zero, and skips out of 
the loop when the end of the entered name is 
found. Each character following the name is read 
into the accumulator (CALL 0235) and compared 
with each letter of the entered name. If at any 
point the entered name does not match the name 
on tape, the program goes back to searching for 
55 (machine program indicator) and the name 
search begins again. 

There is a minor flaw in this process. Let's look 
at the succeeding lines of code: 



02E4 
02E5 



23 
10 F3 



INC 
DJNZ 



HL 
02DA 



This coding increments the HL register to the 
next character and loops back, looking for a total 
of six letters in the name. But what if the 
machine program code (55) is found, and one or 
more characters of the name match, but the rest 
do not match? There is no provision in this 
routine to decrement the HL register pair . . . 
which means that, if only part of a correct name 
has been found.the program will begin its search 
anew until it finds a program that matches only 
the last part of the entered name! This is the 
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reason the SYSTEM routine is not always able to 
search until it finds the correct program, the way 
the BASIC load does. 

Let's assume the best - that a machine 
program was found with the name as entered 
from the keyboard. A CALL is then made to 
022C, where the star or space at 3C3F is toggled 
(XORed) with OA. Star XOR OA is a space, and 
space XOR OA is a star; easily done. 



The SYSTEM Module Continues 



SEA 


CD 35 


02 


CALL 


DS35 


D2ED 


FE 78 




CP 


78 


02EF 


28 B8 




JR 


Z.0SA3 


02F1 


FE 3C 




CP 


3C 


02F3 


20 F5 




JR 


NZ.DSEA 



- searching for either 78 (end of program code) or 
3C (beginning of data block code). If 78 is found, 
the program skips back to 02A9, where a CALL is 
executed to 0314. This subroutine merely reads 
the last two bytes on tape into the HL register, 
preparing the start address. This is saved at 
40DF, the cassette recorder is turned off (CALL 
01F8), and the SYSTEM module is re-entered 
from the start at 02B2. This module is a 
continuous loop, allowing a group of 
machine-language programs to be entered 
sequentially. Only the presence of the slash-start 
address combination will break out of the loop. 



If a 3C is found, the beginning of a block of 
machine code is assumed. (If neither is found, 
the program loops until it finds one or the other). 
Here's a snippet of code: 



OEFS 


CD 35 OS 


CALL 


0235 


0SF8 


47 


LD 


B,A 


02F9 


CD 14 03 


CALL 


0314 


02FC 


85 


ADD 


A,L 


02FD 


4F 


LD 


C,A 



A byte is read and saved in B. At 0314, two 
bytes are read and saved, respectively, in the HL 
register pair. These three bytes are, first, the 
number of bytes to read, and second, the 
two-byte starting address of the block. The 0314 
subroutine leaves the value transferred to H in 
the accumulator; to it is added the value in L, and 
this number, sans carry value, is saved in the C 
register. The C register will be used to calculate 
the checksum for the block being read. 



Curious Checksum 

Each succeeding byte is read from tape and 
placed at the address now specified by HL. That 
byte is also added to the C register to update the 
simple checksum. HL is incremented to the next 
contiguous address, and the loop is iterated until 
B (the number of bytes to read in the block) 
reaches zero. 

When the block is fully read, another byte is 
read from tape. This is the checksum byte, and 
should match the last updated value in the C 
register. If it does match, the program loops 
back, toggles the star, and begins anew the search 
for end-of-program (78) or block header (3C). 

A correct checksum byte, curiously enough, is 
not a necessary element of the SYSTEM module. 
If the checksum is incorrect, the program will 
display a 'C at video location 3C3E, and loop 
back regardless to continue reading the program 
from tape. I first noticed this action when a 
gentleman from New Hampshire called; he had 
been using a tape duplication routine to make a 
corrected copy of a machine language program. 
He had loaded the tape, returned to BASIC, then 
POKEd in a few byte changes. He then 
continued with the duplication. When he loaded 

the tape later on, he got a 'C error message on the 
screen . . . but the program continued to load and 
did execute properly. The checksum was wrong 
because of the byte changes he had made, but the 
program, checksum notwithstanding, was read 
and loaded completely. 

Let's take a look at that final portion of code: 



•OSFE 


CD 35 02 


CALL 


0235 


0301 


77 


LD 


(HL) ,A 


0302 


23 


INC 


HL 


0303 


81 


ADD 


A,C 


0304 


4F 


LD 


C.A 


0305 


10 F7 


DJNZ 


02FE 


0307 


CD 35 02 


CALL 


0235 


03 0A 


83 


CP 


C 


03 0B 


28 DA 


JR 


Z,0SE7 


030D 


3E 43 


LD 


A, 43 


030F 


32 3E 3C 


LD 


13C3E) 


0312 


1B D6 


JR 


02EA 



Overall, these routines give the appearance of 
being reasonable and reliable, and they should 
be. What, then, gives rise to the tape problems? 
Mostly the timing loop in the 0235/0241 
subroutine. The values placed in the B register at 
0248 and 024F are too short for low-grade audio 
processing. Simply stated, the audio waveform 
coming in from tape 'rises' too slowly for the fast 
bit-check loop at 0251 to catch. A 'one' might 
come through, but it comes through too laggardly 
for port FF to have flipped into place. 
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00100 ; 


tmttttttttttttttttttttmtmtmmtmmmmmt 




00110 ! 


VOICE 


INPUT/OUTPUT ROUTINE USING THE CASSETTE PORT AND 




00120 ; 


AMPLIFICATION. CAN BE USED WITH CTR TAPE RECORDERS AND 




00130 ; 


BUILT 


-IN MICROPHONES OR PREFERABLY EXTERNAL CRYSTAL 




00140 ; 


HICS. 


SMALL SPEAKER OUTPUT INCREASES INTELLIGIBILITY. 




00150 ; 


ttmtmtmmmtmttttmttmmtmtttttttmttt 




00160 ; 










4300 


00170 




ORG 


430DH ; 


LOW POINT IN MEMORY 




00180 ,- 




ORG 


6500H ; 


USE WITH DISK BASIC 


OBCC 


00190 MONITR 


EQU 


06CCH ; 


BASIC EXIT [OR OTHER) 


4300 F3 


00200 STABT 


DI 




NO BOTHERSOME STUFF 


4301 CDC9Q1 


00210 




CALL 


01C9H ; 


CLEAR THE SCREEN 


4304 3A3D40 


00220 




LD 


A.1403DH) ; 


START BY RESETTING PORT 


4307 D3FF 


00230 
00240 ; 




OUT 


10FFH) ,A ; 


TO CLEAR INCOMING BITS 




00250 ; 


HttttttttttttimttttttHttttttttttttttittttttttttm* 




00260 ; 


KEYBOARD ROUTINE FOR ENTER (INPUT), CLEAR (OUTPUT], OR 




00270 ; 


UP-ARROW (BASIC). UP-ARROW GOES TO EXIT IF NOT BASIC. 




00280 ; 


mmmmmmmmmmmmmimmmmmmmmmmmmmm 




00290 ; 










4309 3A403B 


00300 t 


EYTST 


LD 


A,(3840H) ; 


GET ENTER/CLEAR ROW 


430C FE01 


00310 




CP 


1 ; 


CHECK IF ENTER PRESSED 


430E SSOB 


00320 




JR 


Z, INPUT ; 


GO TO INPUT ROUTINE 


4310 FE02 


00330 




CP 


2 ; 


CHECK IF CLEAR PRESSED 


4312 2850 


00340 




JR 


Z, OUTPUT ; 


GO TO OUTPUT ROUTINE 


4314 FE08 


00350 




CP 


B ; 


CHECK FOR UP-ARROW 


4316 CA0006 


00360 




JP 


Z, MONITR ; 


OUT TO BASIC OR MONITOR 


4319 1BEE 


00370 
00380 




JR 


KEYTST i 


BACK FOR A VALID KEY 




00390 


mmmmmmmmmmmmmmmi 


mtttttitttttttntmtt 




00400 


INPUT FROM PORT FF (255 DECIMAL 


) AND STORAGE IN MEMORY 




00410 


MMtMMtMttMMMMMMMMMMMMMMMMMMMMf 




00420 










431 B 21A343 


00430 


NPUT 


LD 


HL.MSG01 ; 


GET THE "INPUT" MESSAGE 


431 E CDA728 


00440 




CALL 


28A7H i 


AND DISPLAY ON SCREEN 


4321 3A3D40 


00450 




LD 


A.I403DH) ; 


GET VALUE FOR PORT MASK 


4324 4F 


00460 




LD 


C.A ; 


SAVE MASK IN C REGISTER 


4325 210044 


00470 




LD 


HL.4400H ; 


BEGIN VOICE STORAGE 




00480 




LD 


HL,6700H ; 


BEGIN STORAGE (DISK) 


432B 1608 


00490 


.OOP1A 


LD 


D,B i 


NUMBER OF BITS IN BYTE 


43 2A DBFF 


00500 


-00P2 


IN 


A,(OFFH) ; 


GET VALUE AT THE PORT 


43 2C CB17 


00510 




RL 


A 


STASH IT IN CARRY BIT 


432E CB13 


00520 




RL 


E 


BUMP IT INTO E REGISTER 


4330 79 


00530 




LD 


A,C 


GET VALUE OF PORT MASK 


4331 3A403B 


00540 




LD 


A,(3840H) 


CHECK ENTER/CLEAR ROW 


4334 FEBO 


00550 




CP 


BOH 


CHECK IF SPACE PRESSED 


433B CS5343 


005S0 
00570 




JP 


NZ, ESCAPE 


OUT IF KEYBOARD CLEAR 




00580 


! tm 


NOTE: 


DELAY VALUE USED It 


THE B REGISTER IS MM 




00590 


; MM 


CHOSEN 


FOR OPTIMUM INTELL 


GIBILITY.WITH THE tilt 




00600 


; MM CTR TAPE RECORDER AND HAR! 


3WARE MODIFICATION. MM 




00610 


; MM 


A LONGER VALUE CAN BE USE! 


) IF HIGH-FIDELITY #»# 




00620 


; mm 


INPUT 


[S PROVIDED. FOR & 


U3H INCREASE IN THE MM 




00630 


; mm 


B-REGISTER DELAY VALUE, A 


SO INCREASE THE B- MM 




00640 


1 MM 


REGISTER BY THE SAME AMOU 


*T FOR PLAYBACK. MM 




00650 


; MM 


LIKEWISE, A DECREASE IN Tl 


iE DELAY VALUE MAY MM 




00660 


; MM 


INCREASE FIDELITY AT A SA( 


ORIFICE OF MEMORY. MM 




00670 










4339 0604 


00680 




LD 


8,4 


GET SHORT DELAY VALUE 


433B 10FE 


00690 


DELAY1 


DJNZ 


DELAY1 


AND DELAY A WHILE 


433D D3FF 


00700 




OUT 


(OFFH),A 


MUST RESET PORT INPUT 


433F 15 


00710 




DEC 


D 


DECREMENT TOTAL BITS 


4340 C22A43 


00720 




JP 


NZ.L00P2 


CONTINUE IF MORE TO DO 


4343 73 


00730 




LD 


(HL1.E 


; SAVE FULL BYTE IN MEM. 


4344 23 


00740 




INC 


HL 


; GO ON TO NEXT BYTE 


4345 7C 


00750 




LD 


A,H 


; GET VALUE OF M.S. BYTE 


4346 FEOO 


00760 




CP 


OOH 


; USE FOR 4BK MACHINE 




00770 


; 


CP 


OCOH 


; USE FOR 32K MACHINE 




00780 


; 


CP 


080H 


; USE FOR 16K MACHINE 


43 48 C22B43 


00790 




JP 


NZ.L00P1A 


; IF NOT DONE THEN MORE 


434B 21C743 


00800 




LD 


HL.MSG02 


i GET "INPUT COMPLETE" 


43 4E CDA72B 


00810 




CALL 


28A7H 


; AND DISPLAY THE MESSAGE 


4351 1BB6 


00820 
00830 




JR 


KEYTST 


; DONE - BACK TO KEY TEST 




00840 


! mmmmmmmmmmmmmmm 


MMMMMMMMMMMMi 




00850 


; PAUSE CHECK 


DURING ENTRY: SPAC 


EBAR = GO, OTHERWISE STOP 




00860 


; ttmtHtmttt#ttm$mtt$te 


MtMMMMMMMMMMM 




00870 


; 








4353 E5 


00B80 


ESCAPE 


PUSH 


HL 


; SAVE CURRENT POINTER 


4354 CDAFOF 


00890 




CALL 


OFAFH 


; DISPLAY CURRENT MEM. 


4357 213944 


00900 




LD 


HL.MSG05 


J GET "WORD START" MESS. 


435A CDA72B 


00910 




CALL 


28A7H 


; AND DISPLAY THE MESSAGE 


4350 E1 


00920 




POP 


HL 


J RESTORE MEMORY PTR. 


435E 3A403B 


00S30 


RECHEK 


LD 


A,(3B40H) 


i ENTER/CLEAR KEYBRD ROW 


4361 FEBO 


00940 




CP 


BOH 


j CHECK IF SPACE AGAIN 


4363 28C3 


00950 




JR 


Z.L00P1A 


; BACK TO MAIN LOOP 


4365 FE04 


00S60 




CP 


4 


; CHECK IF BREAK KEY 


4367 20F5 


00970 




JR 


NZ, RECHEK 


; KEEP LOOKING ENT OR BRK 


4369 21C743 


00980 




LD 


HL.MSG02 


; GET "INPUT COMPLETE" 


436C CDA72B 


00990 




CALL 


28A7H 


; AND DISPLAY THE MESSAGE 


436F 1B9B 


01000 
01010 


> 


JR 


KEYTST 


; AND BACK TO KEY MENU 



Special Loaders 

This was initially one of the mysteries of 
TRS-80 operations. Microchess was produced 
with a loader, then others quickly followed, 
mysteriously taking control of the machine and 
locking it up completely. 

Let's now take a look at some of these special 
loaders, which will be designated Loaders A, B, 
C, and D in order to help them continue to do the 
job they were supposed to - protect software. 

Loader A sets up a stack at 5000, clears the 
accumulator, and calls ROM to turn on the tape 
recorder and find the sync byte. It places a star 
on the bottom of the screen, sets up the HL 
register to receive the program, and prepares 
register C to perform simple checksum. A byte is 
read, it is saved in memory, and the checksum is 
created as in the SYSTEM mode. Then: 



4D25 


7C 






LD 


A,H 


4D26 


1F 






RRA 




4DZ7 


23 






INC 


HL 


4D28 


3E 


2A 




LD 


A,2A 


4D2A 


DA 


2F 


4D 


JP 


C,4D2F 


4D2D 


3E 


2D 




LD 


A, 20 


4D2F 


32 


FD 


3F 


LD 


(3FFD) ,A 


4D32 


3E 


4C 




LD 


A,4C 


4D34 


BC 






CP 


H 


4D35 


C2 


1F 


4D 


JP 


NZ.4D1F 


4D3B 


3E 


FF 




LD 


A,FF 


4D3A 


BD 






CP 


L 


4D3B 


C2 


1F 


4D 


JP 


NZ.4D1F 


403E 


B9 






CP 


C 


4D3F 


C2 


00 


00 


JP 


NZ,0000 


4D42 


CD 


FB 


01 


CALL 


01 FB 


4D45 


C3 


80 


47 


JP 


47B0 



The strange appearance of RRA has nothing to 
do with rotating incoming bits. Rather, since the 
accumulator contains the H register value, each 
page (256 bytes) of information will change the 
high page value by one. Consequently, the high 
page will alternate between odd and even values, 
and the least significant bit, rotated into the 
carry flag, will trigger the display-star or 
display-space routines at 4D2F. 

Finally, this somewhat awkward loader does a 
pair of compares to see if it has yet reached 4CFF, 
the end of the program load. If not, it loops back 
and continues; if so, it examines the checksum in 
C. Amazingly enough, it goes back to MEMORY 
SIZE? if there is a checksum error! There's no 
tampering with this program. A successful load 
is followed by a jump to the program's beginning 
at 4780. 

Loader B is virtually identical to Loader A, 
except that the beginning of the program is found 
at 41FD instead of 4780. 

Loader C is of a more interesting variety. It is 
written entirely without calls to ROM, because it 
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Continued Listing 





01020 


#################«##########################«######## 




01030 


OUTPUT FROM 


MEMORY OF RECORDED VOICE TO CASSETTE PORT 




01040 


ttmnttniHttttttttttttttttttttttntttmttttttttttt 




01050 








4371 21E743 


01060 OUTPUT 


LD 


HL,MSG03 


GET "BEGIN OUTPUT" 


4374 CDA72B 


01070 




GALL 


2BA7H 


AND DISPLAY THE MESSAGE 


4377 3A3D40 


01080 




LD 


A,(403DH) 


PORT FF OUTPUT MASK 


437A 4F 


01090 




LD 


C,A 


SAVE OUTPUT MASK IN C 


437B E1DD44 


01100 




LD 


HL.4400H 


START VOICE STORAGE (*) 


437E 1B0B 


01110 


-00P3A 


LD 


0,8 


NUMBER OF BITS IN BYTE 


4380 7E 


01120 




LD 


A.tHLl 


GET VALUE FROM MEMORY 


43at 5F 


01130 




LD 


E,A 


SAVE IT IN E REGISTER 


43 BS AF 


01140 




XOR 


A 


CLEAR ACCUMULATOR TO 


4383 CB13 


01150 L00P4 


RL 


E 


SEND BIT TO CARRY FLAG 


4385 CB17 


01160 




RL 


A 


AND ROTATE 'ROUND TO A 


4387 B1 


01170 




OR 


C 


USE THE PORT FF MASK 


4388 D3FF 


01180 




OUT 


(OFFH) ,A 


AND SEND OUT THE VALUE 




01190 










01200 


»« 


NOTE: 


PLAYBACK VALUE BELOW MUST BE CHANGED »## 




01210 


WUS 


TO MATCH SAMPLING DELAY IN THE INPUT SECTION UU 




01220 


#«# 


OF THIS I/O PROGRAM. THIS VALUE IS ROUGHLY ##« 




01230 


#«# 


TWO TIMES THAT IN THE B-REGISTER DURING THE Uit 




01240 


#### 


INPUT SAMPLING. VARIOUS DUMMY OPCODES MAY tit* 




01250 


att 


BE INSERTED WHERE NECESSARY TO KEEP VOICE ##« 




01260 


tttl AT THE 


PROPER PITCH AND QUALITY. USING THIS ##« 




01270 


tttt 


PROGRAM, THERE IS A QUARTER-TONE DIFFERENCE. #i?## 




01280 








438A 0606 


01280 




LD 


B,6 


GET SHORT DELAY VALUE 


4380 10FE 


01300 [ 


JELAY 


DJNZ 


DELAY 


AND DELAY SHORT WHILE 


438E AF 


01310 




XOR 


A 


CLEAR ACCUM. BACK TO 


438F 15 


01320 




DEC 


D 


BITS = BITS MINUS ONE 


4390 028343 


01330 




JP 


NZ,L00P4 


AND BACK FOR SOME MORE 


4393 23 


01340 




INC 


HL 


GET NEXT BYTE FROM MEM. 


4394 70 


01350 




LD 


A,H 


GET VALUE OF M.S. BYTE 


4395 FEDO 


0136D 




CP 


OOH 


FOR 4BK MACHINE 




01370 




CP 


OCOH 


FOR 32K MACHINE 




01380 




CP 


080H 


FOR 16K MACHINE 


4397 027E43 


01390 




JP 


NZ,L0DP3A 


AND GO BACK FOR MORE 


43 9A 210E44 


01400 




LD 


HL.MSG04 


GET "OUTPUT COMPLETE" 


439D CDA728 


01410 




CALL 


2BA7H 


AND DISPLAY THE MESSAGE 


43A0 030943 


01420 




JP 


KEYTST 


AND BACK WHEN DONE 




01430 








43A3 48 


01440 ( 


4SG01 


DEFM 


•HOLD SPACE BAH AND BEGIN SPEAKING.' 


4305 OD 


01450 




DEFB 


OOH 


4306 00 


01400 




DEFB 


OOH 


4307 49 


01470 t 


1SG02 


DEFM 


'INPUT COMPLETE OR MEMORY FULL.' 


43 E5 OD 


01480 




DEFB 


OOH 


43 E8 00 


01490 




DEFB 


OOH 


43 E7 42 


01500 t 


■ISG03 


DEFM 


'BEGINNING PLAYBACK; BREAK IS IGNORED.' 


440C OD 


01510 




DEFB 


OOH 


440D 00 


01520 




DEFB 


OOH 


440E 50 


01530 ^ 


ISG04 


DEFM 


'PLAYBACK COMPLETE; PRESS CLEAR TO REPEAT 


4437 OD 


01540 




DEFB 


OOH 


4438 00 


01550 




DEFB 


OOH 


4439 20 


01560 f 


1SG05 


DEFM 


• = WORD SEPARATION POINT.' 


4452 OD 


01570 




DEFB 


ODH 


4453 DO 


01 580 
01590 




DEFB 


OOH 




01 600 


tmntttttttt*ttt*tti*t**Htuttttt*Mt*t**tmttttttt 


4300 


01610 




END 


START 


00000 TOTAL ERRORS 








29121 TEXT AREA BYTE 


■£ LEFT 




DELAY 43 8C 


01300 C 


1300 






DELAY1 433B 


00690 C 


0690 






ESCAPE 4353 


00880 C 


0560 






INPUT 431 B 


00430 C 


0320 






KEYTST 4309 


00300 00370 00820 01000 01420 


L00P1A 4328 


00490 C 


0780 00850 




L00P2 432A 


00500 C 


0720 






L00P3A 43 7 E 


01110 C 


1390 






LO0P4 4383 


01150 C 


1330 






MQNITR 0600 


00190 C 


0360 






HSG01 43A3 


01 440 t 


0430 






MSG02 4307 


D1470 C 


0800 00980 




HSG03 43E7 


01S00 C 


1060 






MSG04 440E 


01 530 C 


1400 






MSG05 4439 


01560 C 


0900 






OUTPUT 4371 


01060 C 


0340 






REEHEK 435E 


00930 C 


0970 






START 4300 


00200 t 


1610 









is capable of loading into a Level I or Level II 
TRS-80. Less fortunately, the ROM timing 
errors are not corrected, so the chances of loading 
this program on a marginal machine are not at all 
improved. The stack is prepared, and a block of 
memory is cleared from 5800 to the end of 
potential RAM at FFFF. My only guess as to the 
reason for this is that the authors wish to wipe 
out any programs such as monitors or 
disassemblers, as the clearing byte (A5) does not 
strike me as otherwise meaningful. 

The tape is then turned on, and a pattern of 
three asymmetrical and two symmetrical sync 
bytes is found (Bl, 83, 79, 5A, 00). Again, the 
choice strikes me as arbitrary, and may be the 
authors' way of identifying their own code. If 
these bytes are found, the program continues; if 
not, the entire five-byte pattern is sought again. 

As in the other loaders, register C is set to zero 
for use as a checksum byte. The program load 
point is set high in memory (747F), and a byte is 
read. Here is a part of the code: 



4330 


CD 


8F 


43 


CALL 


438F 


4340 


77 






LD 


(HL),A 


4341 


32 


3F 


3C 


LD 


(3C3F),A 


4344 


81 






ADD 


A,C 


4345 


4F 






LD 


C,A 


4348 


2B 






DEC 


HL 


4347 


70 






LD 


A,L 


4348 


3C 






INC 


A 


4349 


02 


53 


43 


JP 


NZ.4353 


43 4C 


CD 


8F 


43 


CALL 


43 BF 


43 4F 


B9 






CP 


C 


4350 


C2 


66 


43 


JP 


NZ.4366 



The secret to this portion of code rests in 
address 4346. Unlike most other loaders, this one 
loads (and displays) the last byte of code first, 
moving backwards through memory. (438F is the 
location of the byte-read subroutine). When the 
page is crossed (4346-4348), the checksum is 
evaluated; if the checksum is incorrect the 
program jumps to 4366, where an error message is 
displayed and the machine locks up. 

The user's display is worth noting: 



4353 7C 

4354 32 3E 3C 



LD 
LD 



A,H 
(3C3E) ,A 



This loader actually displays the ASCII 
equivalent of the page of memory being loaded 
with data . . . and it looks like an alphanumeric 
countdown as the program is fit into place. 

Finally, Loader C does a comparison for the 
end of the first major load block, changes the 
value of H, and loads the next block. It then 
overwrites critical portions of the load routine, 
effectively obscuring the loading and entry point 
of the program. Interrupts are disabled, and the 
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process moves out of the loader into the main 
program. Interestingly, the authors forgot to 
turn the tape recorder off. 

Finally, Loader D is of an entirely different 
sort. First, some code: 



BEFE 


3E 


04 


LD 


A, 4 


BFOO 


D3 


FF 


OUT 


IFF), A 


BFQ2 


DB 


FF 


IN 


A.tFF) 


BF04 


17 




RLA 




BFOB 


30 


FB 


JR 


NCBF02 


BF07 


DS 


XX 


LD 


B,XX 


BFOS 


10 


FE 


DJNZ 


BF09 


BFOB 


06 


OS 


LD 


B,9 


BFOD 


3E 


04 


LD 


A, 4 


BFOF 


D3 


FF 


OUT 


(FF) ,A 


BF11 


OB 


FF 


IN 


A.tFF) 


BF13 


17 




RLA 




BF14 


00 




NOP 




BF15 


3B 


OC 


JR 


C,BF23 


BF17 


23 




INC 


HL 


BF1B 


2B 




DEC 


HL 


BF1B 


10 


F6 


DJNZ 


BF11 



This remarkable loader is written for 
high-speed operation, setting up the output ports 

BEFE and BFOD), clocking itself with start bits 
(BFOD), and then reading a nine-bit serial 
stream. Careful timing and self-clocking are 
essential in high-speed data I/O, and this routine 
is capable of reading and writing on ordinary 
audio cassettes, with excellent reliability, at 
better than 2000 baud. The only point to the 
instructions at BF17 and BF18, for example, is 
the delay introduced by executing them; yet that 
timing is very important. The actual timing 
value at BF07 has been dropped for a measure of 
protection of this author's fine software. 

Conclusions 

In sum, the tape read/write routines of the 
TRS-80 are efficient and, especially now with 
special loaders and a corrected ROM, quite 
reliable. Different levels of user prompts, 
particularly those used by the reverse-loading 
module described above, are probably more 
satisfactory than flashing stars. A checksum 
process for BASIC similar to the SYSTEM 
module would have been valuable. Finally, by 
careful attention to clocking details, a reliable, 
higher speed loader could have been included in 
the TRS-80. 

For those especially interested in high-speed 
loaders, I recommend examining the Exatron 
Stringy-Floppy operating system, which shows 
what can be done with equipment designed for 
digital operation. It is capable of reliable loading 
and saving at rates exceeding 11,000 baud. 




Fig. 2. Full schematic lor the Model I cassette modification lor speech input. It should 
be switched out when cassette programs are being loaded (see Fig. 41 
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Fig. 3a. 




Fig. 3b. 
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Simple Modifications 

Why hardware modifications? Simply 
because they help a limited computer broaden 
its ability to serve our needs. Looking at glowing 
blue-white letters on a dark screen is 
comfortable for only a limited time . . . waiting 
through many minutes for the computer to make 
a game play is frustrating . . . attempting to 
imagine which characters are upper case and 
which are lower case is nearly impossible . . . 
emphasizing individual words and characters is 
only possible with arrows and stars . . . and so 
forth. 

In this chapter, eleven simple modifications to 
the standard TRS-80 will be presented: 

Installing 16K memory to the keyboard unit, 
and to the expansion interface. 

A change to enable recovering Resets when 
there is an expansion interface attached. 

Moving the Reset button to a more accessible 
position. 

Adding both an extra keyboard and an extra 
video output for extending the computer's 
portability. 

Adding an RF modulator to further increase 
the TRS-80's portability. 

Installing a modification to increase the 
computer's computational speed. 

Installing a modification to reverse the video 
display for black letters on a white 
background, more in keeping with real text. 



Adding the feature of dual-language 
operation: Level I and Level II in the same 
computer. 

Accessing the lower case capabilities built 
into the TRS-80 by adding a single circuit. 

Reversing individual characters on the 
screen for emphasis. 

Adding a hexadecimal keypad for faster 
entry of machine code information. 

Almost all of these modifications will require 
you to open the cabinet of your TRS-80. Should 
you do it? Or should you not? First of all, 
consider that your computer has but a three 
month warranty; after that, you will have to pay 
repair charges should something go wrong. 
Radio Shack has, in response to public protests, 
changed its former policy and will now repair 
machines with the most popular modifications 
installed, at no extra charge. They will not 
remove those modifications if you say so, but 
may refuse repair if (a) you have mangled the 
board, or (b) if you cannot document your 
modifications. 

Yes, there is a chance that you can damage 
your TRS-80 when you make modifications. 
This will not be the fault of the modifications 
themselves, though. My own TRS-80 has been 
modified many times, and the only damage has 
been to the notoriously flakey cable that 
connects the keyboard to the main circuit card, 
and the failure of one RAM chip. The latter 
would have happened anyway. 
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How many TRS-80's have been damaged 
during modification? That's a hard question to 
answer, but I will describe briefly the failed 80's 
I have seen: 

1. A damaged integrated circuit in the data 
section was caused when heavy wire was used 
to make the modification. 

Lesson — use the parts specified. 

2. Two RAM chips were blown when the user 
dropped a soldering iron into the unit when he 
was modifying it. 

Lesson — always turn the power off when 
making the physical changes. 

3. A blown power supply regulator. The user 
had left the unit under an open window. 
Lesson — close the windows in case of rain! 

4. High levels of garbage causing keyboard 
lockout and blown programs. The computers 
were being used next to heavy electrical 
equipment. 

Lesson — treat the computer as if it were a 
very sensitive piece of electronic equipment. 
It is. 

5. Constant keyboard lockout or odd 
characters. The TRS-80 cable had been 
flexed too many times, causing breaks. These 
breaks had destabilized the keyboard circuits, 
causing two ICs to blow. 

Lesson — handle the keyboard cable, that 
most delicate of hardware, with utmost care. 



6. Constant lost memory and programs. The 
RAM chips were not being 'refreshed' because 
the refresh multiplex line was not working. 
The user had plugged in a peripheral device 
upside down, with the power on to both. 
Lesson — make all interconnections with the 
power off. 

In sum, all the above damage was caused by 
carelessness, haste, or attempting to use 
inappropriate materials to do the job. The 
solutions? Resolve not to do all the work in one 
evening. Turn back to the introduction to make 
sure you have the right tools. Work slowly and 
take breaks often. Buy parts from reliable 
suppliers. Read and understand the instructions 
and the theory before you start. 

And finally, if you have any serious doubts 
about the accuracy of the printed information, 
contact the author. That's me. And if you have 
any problems that won't go away, write. If you 
write, you must enclose a self-addressed, 
stamped envelope, a complete description of any 
problem, and all tests you have made. Also, I 
cannot cover much beyond the scope of this book, 
which includes the myriad competing disk 
operating systems and support software. 

Expanding the Memory 

The simplest modification, once you have 
braved opening the cabinet, is expanding the 
unit's memory from the 4K supplied to a full 
16K RAM. At this writing, 16K of reliable RAM 
memory can be purchased for less than $20. 



Keep It Clean! 

If you examine the contacts on the keyboard 
unit's edge-card connector, as well as on the five 
connectors (expansion in, expansion out, 
printer, RS-232, disk) of the Expansion 
Interface, you will see a major cause of the TRS- 
80's instability: solder-plated connectors. In the 
interest of economy, Radio Shack did not use 
gold to ensure a good cable contact. This turned 
out to be a serious error in judgment. 

There are two options in dealing with these 
solder-plated connectors. The first is to keep 
them clean. Remove the cables regularly and 
vigorously rub the contact surfaces with a 
dollar bill or talc buffing wheel. Bring the 



solder to a bright shine, and spray it with 
contact cleaner. Reinstall the cables and 
memory crashes should lessen. 

The other option is expensive and 
time-consuming, but much more reliable. The 
contacts can be freed of solder plating with 
solder wick, cleaned with flux remover, brushed 
to a high shine, and a soft silver compound can 
be flowed onto the edge contacts. Fuller 
Software (see Appendix I) sells a contact 
plating kit; price varies with the price of silver, 
but at this writing it is more than $20. The 
process is very tedious because silver melts at a 
much higher temperature than lead, but the 
results are noise-free connections and greater 
reliability. 
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There are several types of so-called '16K 
memories', so when you set out to upgrade your 
TRS-80 memory, make sure you order the 
correct type. 16K is actually a shorthand term 
for 16,384 bytes of memory. In the TRS-80, the 
16K memories are integrated circuits containing 
16,384 single-bit memory cells each. To create 
an entire byte, then, eight integrated circuits are 
needed. Furthermore, the TRS-80 memory 
needs very little power, and must take only a 
small amount of space in its cabinet. The only 
small, low-power memories made are 'dynamic' 
memories. The 16K-by-one-bit, dynamic 
memory is industry type 4116, also called type 
416. 

There is one other consideration in purchasing 
memory expansion chips, and that is a popularly 
misunderstood quality called access time. 
Access time can be thought of as the time it 
takes the computer to inform the memory chip 
that it needs information (or will give it 
information) until the memory chip is 
electronically ready to respond. This figure is 
usually given in nanoseconds (see Table 4-1). 

Second 1 

Millisecond (mS) 0.001 

Microsecond tuS) 0.000001 

Nenosecond (nS) 0.000000001 

Table 4-1. Relative time units. 

This time is very small but quite critical to the 
operation of the computer. If the memory is not 
ready, programs and data will be recorded or 
reported incorrectly, and the computer will have 
no chance of working properly. The minimum 
access time for memory in an unmodified TRS- 
80 is 450nS; with the speed-up modifications 
presented in this book, that figure drops to 300 
nS or less. 

Most of the current crop of memory chips 
easily meet the 450 nS requirement, and many of 
those sold as 450 nS chips can be run reliably at 
300 nS. A problem arises with the expansion 
interface, as older units had a bit of trouble with 
'hotter' (faster) memory. So as a general rule, 
refer to Table 4-2 when looking for memory to 
upgrade your TRS-80 or its expansion interface. 



Equipment 



TRS-BO keyboerd unit, unmodified 
TRS-80 keyboard unit with Bpeed-up 
Expansion Interface made before 1/80 
Expansion Interface made after 1/BQ 
Expansion Interface made before 1/80 

with speed-up 
Expansion Interfece madB after 1/80 

with speed-up 



Access Time 

450 nS mBX. 350 nS optimum 

300 nS max, 250 nS optimum 

300 nS min, 450 nS max 

450 nS max, 350 nS optimum 

300 nS min optimum 

300 nS max, 250 nS optimum 



Table 4-2. Memory access time for various TRS-SOs. 



Opening and Closing the Case. 

1. Locate a spacious workplace, and set a 
soft towel on it. You will need a Phillips 
screwdriver and a small box in which to set 
the screws and spacers. 

2. Remove the power and disconnect all 
cables to the keyboard unit. Set it face down 
on the towel. 




.... ™JP&» 

Photo 4-1. Photos showing opening computer. 

Unit is placed face down and screws are removed On newer 
units one screw is beneath a warranty notice. 

3. There are six screws of three different 
sizes which hold the case together. In later 
TRS-80's, one of these is covered by a label 
warning you not to go inside. This label just 
won't peel off for later use. You'll have to 
punch through it to remove the last screw. 

4. Hold the case together and place it face 
up on the towel. Gently lift off the top cover. 

Some TRS-80's have a 'flying lead' LED 
(light-emitting diode) power indicator, 
meaning you will have to pull it gently out of 
the hole in the top cover. Other power 
indicators are fastened to the keyboard, and 
the cover lifts off directly. 











Computer is placed face up and the top removed by lifting back 
and up. 
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5. This step is the most delicate. Lift the 
keyboard slightly upward, and then swing it 
toward you. A cable attaches from the 
keyboard to the main circuit card at the 
bottom left side. This cable is made up of 
flat copper bands which have a tendency to 
break when flexed. 










\ 







\ 



JS§ 



Keyboard is rocked gently forward to show white plastic spacers, 
which are then removed. 

6. While holding the keyboard up at about p 
90-degree angle, look at the main circuit 
card. There are five soft plastic white 
spacers which cushion the keyboard. On 
later models, a sixth, central spacer is hard 
plastic. Note their positions, remove them, 
and set them in the parts box. 

7. Swing the keyboard downward gently, 
and lift the entire computer out of the base 
of the cabinet. Set the computer down and 
put the base aside. 
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With the keyboard supported upright against a firm backing, the 
CPU board is lifted from the case bottom. 



8. Most modifications will be done to the 
integrated circuit side of the circuit board, so 
turn the entire unit face down again. Unless 
the modification calls for work on the solder 
side of the board, do not flex the keyboard 
cable again. 

9. If the modification calls for work on the 
bottom of the board, get a heavy box or 
other support. Set the keyboard face up, 
and swing the keyboard out and up a bit 
wider than 90 degrees, leaning it against the 
support. Never open the unit fully like a 
book, as this badly deforms the interconnect 
cable. 
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Tfte complete unit is ready for work with the keyboard supported 
at a 90-degree angle. 



10. To close the case, fold the unit back 
together, and set it into the base. The unit 
may have to be jostled gently to get it to fit 
over the plastic support posts. Make sure 
any added wires do not get caught and cut 
by the support posts. 

11. Lift the keyboard slightly and restore 
the white spacers to their former positions. 
Fit the keyboard back into place. 

12. If any long wires or cables have been 
added, make sure they all clear the cabinet 
edges. Restore the LED to its place on the 
keyboard top if it is a flying-lead type, or 
straighten the LED on the circuit card so it 
fits into the cover hole. 

13. Fit the cover into place lightly, making 
sure there are no newly installed parts being 
crushed or bent in the process. Be sure no 
leads creep out the joints on either side. 

14. Holding the unit together firmly, flip it on 
its face. While holding it with one hand, drop 
the screws into the holes, longest one towards 
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the top. Fasten one screw on either side; this 
will hold the computer together while you 
tighten the remainder. 

15. Remember that the case is soft plastic, 
so just tighten enough to pull the two sides 
together. Otherwise, the plastic may be 
stripped and the screws will fall out. If that 
happens, drop in some clear acrylic cement 
(not white glue), and insert the screw. 
Remove it just before the glue hardens, and 
replace it about an hour later. 

16. Flip the computer on its back, restore 
cables, and turn on the power. If the 
slightest problem seems apparent, open up 
and try again! 




Photo 4-2. Memory chip area in TRS-80. 

Power Supply and Memory: 2N5594 transistor handles 5-volt 
supply; adjustments are seen at top of photo. 1 6K RAM chips are 
plugged into sockets Z13 to Z20, unusually close to the power 
transistor's heat sink. Replacement memory chip in socket Z13 
attests to the degrading capacities of excess heat 



Tips on Handling Integrated Circuits 

In the early days of microcomputers, there 
was a lot of user hesitation about installing 
memory chips because of warnings about static 
electricity damaging the memory devices. At 
that time the fear was reasonable; but today 
(with just a little caution) there need be no 

problem. 




Figure 4-1. Grounding a soldering iron. 



1. Never place any integrated circuit on highly 
charged plastic material, especially styrofoam. 



2. Handle memory chips, CPUs (such as the 
Z-80), LSI devices (large-scale integrated 
circuits, usually those with 28 or 40 pins), or 
any marked MOS, CMOS, or NMOS 
(metal-oxide semiconductors), with care. 
Hold them by their ends, never by the 
connection pins. 

3. Purchase a static-free workbench, which is 
a conductive cloth sheet with a wrist strap 
and safe grounding cable. These can be 
obtained from Wescorp for about $18. 

4. Ground your soldering iron to an earth 
ground but only through a series-connected 
one-megohm resistor — never directly! The 
grounding is not absolutely essential, but 
helps if you live in a very dry, static- 
producing environment. 

5. Work with any integrated circuits with the 
power off. Make sure the integrated circuit's 
ground and power pins are all connected 
(soldered or in sockets) before turning on the 
juice! A difference of a mere half a volt 
between certain pins can kill an IC. 

6. Use high-quality sockets for integrated 
circuits wherever you can. This will not only 
keep excessive heat away from them, but will 
also save the day if one is damaged. 
Unsoldering a 40-pin integrated circuit is not 
pleasant. 

7. Above all, work slowly and carefully. By 
far the greatest villain is haste. Oh yes — do 
keep furry animals out of the area! 
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Leue; J iiOMs: Rockwell single-chip ROM and Motorola 2-chip 
set are pushed into aluminum- foil-covered vegetable tray. 

Before installing your new memory chips, take 
a styrofoam meat or vegetable tray, trim off the 
curved ends, and cover the center with aluminum 
foil. This will be your static-free storage for the 
4K memory chips you will be removing. To 
install the 16K memory in your keyboard unit, 
turn off the power, open the case and find the 4K 
memory chips. 

Slide a thin-bladed screwdriver under the end 
of one of these chips, and rock it slighly upwards. 
Slide the blade under the other side, and rock. 
Move back and forth gently until the chip is free, 
but don't spring it out of the socket. Lift it by the 
ends and press it into the foil-covered tray. As 
you are doing this, notice that each of the chips 
has a notch or dot at one end. Keep this position 
in mind; the 16K chips will be installed in the 
same direction. 
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Figure 4-2. 1 6K RAM expansion shunt versions. 



Once all the 4K chips have been removed, lift 
the 16K chips one at a time and press them in the 
empty sockets. If the pins are spread too wide, 
set the chip sideways on the foil-covered tray and 
press gently. Try again to insert the chips. Be 
sure none of the pins are bent underneath, or 
slide outside the socket. 

Now turn your attention to a pair of on-board 
sockets marked Z3 and Z72. 16K chips will need 
more attention from the address lines, so these 
decoding shunts will have to be changed. If you 
didn't receive these shunts with your order of 
16K chips, have no fear — just slide wires into 
the sockets. Or, obtain an 8-position DIP switch 
and push it into the socket. Turn the switches 
on where the shunt is to be connected, off where 
the bars are broken. Figure 4-1 shows the old 
and new positions of the shorting bars or wires of 
these shunts. 

When you have placed the new, corrected 
shunts, switches or wires into sockets Z3 or Z72, 
and all the 16K chips are installed, the keyboard 
upgrade is complete. Reinstall the computer in 
its case, turn on the power, and press (ENTER) 
in response to MEMORY SIZE? Then PRINT 
MEM, and you should see a value of 15572 (15570 
on newer machines). If you don't get that value, 
turn the machine off and troubleshoot: 

1. MEMORY SIZE? reads much less than 
15570. Turn off the computer and try again. 

If you have no expansion box, type SYSTEM 
(ENTER) /0 (ENTER), and keep trying. If 
the value never changes, you may have either a 
bad memory chip or incorrect shunt wiring. Go 
back to MEMORY SIZE?, only this time enter 
15560. If you get the READY message, this 
might point to a failed memory chip or an 
incorrect DIP shunt (especially if PRINT 
MEM? reads the same as that for 4K). To test 
memory, run the RAM test printed in Chapter 3. 
If instead you get the flash of an ?OM ERROR 
and a return to MEMORY SIZE?, then suspect 
that you've wired the shunt or shorting wires 
incorrectly. 

2. You get a partial RADIO SHACK LEVEL 
H BASIC (or R/S LEVEL 2 BASIC) message, 
with or without READY, and with or without 
incorrect characters, but it only lasts for a 
short time before crashing back to MEMORY 
SIZE? 

Suspect that a memory chip is very balky, is 
inserted only partly or with pins bent, or that 
you've lifted the Level II interconnect cable (if 
your unit has one). You may also have damaged 
some other circuitry, but this is very unlikely. 
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3. The screen never gets past a pile of 
garbage. 

You may have lifted the Level II interconnect 
cable (if your unit has one), one or more memory 
chips may be completely dead, inserted 
backwards or only partly, or you may have 
forgotten to reinstall (or have reversed) either of 
the two shunts at Z3 and Z72. 

4. Unexpected characters are displayed after 
MEMORY SIZE?, sometimes acting as if 
they were 'entering' themselves. 

You have broken one or more wires of the 
keyboard interconnect cable. You can look for 
cracks, or just replace the whole cable. 

5. The machine responds correctly, but only 
for a short while; it often crashes; occasionally 
PRINT MEM will give a smaller number 
than 15570, but not always. 

This is probably balky memory or memory 
that is the wrong speed (usually older, slower 
memories that some discount houses may sell). 
For starters try reinserting the memory in case of 
a bad contact; run the RAM test; or just buy 
new memory. 

6. The computer displays a screen full of 999, 
etc. 

You have lifted the Level II interconnect cable 
out of its socket. Replace it very carefully. 

Adding to the Expansion Interface is a much 
easier task. Your keyboard unit must have 16K 
in it already in order that the memory map be 
complete from 4000 (decimal 16384) to the start 
of expansion box memory at 8000 (decimal 
32768). And, sadly, you cannot use your 4K 
chips in the expansion box without a hardware 
modification. 

First, remove the cover over the power 
supplies and remove them; this will prevent 
them from tumbling all about when you open 
the bottom cover. Now flip the expansion box 
over and remove and set aside the six screws that 
fasten the cover. Also disconnect the power 
cable inside the expansion interface case. 

Inside, you will find two rows of empty sockets 
for memory expansion. The first 16K of 
expansion memory goes in the sockets marked 
Z9 to Z16, and the second 16K into sockets Zl to 
Z8. The memory must be inserted in this order, 
unless you want a permanently protected, 16K, 
high-memory block (which might be useful). 
Use the same procedure for installing these 
memory chips as for the keyboard unit, facing 
them in the direction of the notch on the sockets. 
Once again, check carefully for bent pins or pins 



out of the sockets, reinstall the cover, and power 
up the interface and keyboard. 

Press ENTER in response to MEMORY 
SIZE?, and your 32K machine should read 
31956, and the 48K machine will read 48340 (two 
bytes less each in later models). Early 
expansion boxes, because of design flaws in 
memory timing, are significantly more sensitive 
to memory speed. If expansion memory is 
occasionally balky or shows frequent glitches 
when peripheral devices are attached, make the 
hardware changes to Z69 recomended in the 
200% speed modification (later in this Chapter). 
Seeming memory failures can most often be 
attributed to these timing problems, although 
earlier interfaces (particularly those with the 
bulbous buffered cable) had hardware 
difficulties which made them extremely 
sensitive to noise and vibration. 

Most of these earlier units had their circuit 
board layout and plating done in such a way that 
a sharp tap on the box, board, or cable would 
cause a 'microphonic' reaction. That is, the 
vibration would be transmitted along power 
supply and signal lines, interfering with the 
actual data. The result would be frequent 
memory crashes. Likewise, a noisy environment 
(nearby washers, mixers, fluorescent lights, 
transformers, and even printers) can cause 
electronic interference which would disrupt 
memory. 

Rescuing the RESET 



Among the conveniences of the TRS-80 
keyboard computer is the Reset button. A 
program, especially one with machine language 
components, may cause the computer to 'hang'. 
The Reset button conveniently recovers control 
of the machine and returns it to you. 

Once the Expansion Interface is connected, 
though, things begin to change. The Reset 
button becomes a Reboot button, causing any 
operating programs in memory to be lost and the 
complete system to restart from initialization of 
the disk operating system (see Supplement to 
Chapter 1, on the power-up sequence). 

As an aside, let me note that the Z-80 HALT 
instruction does not have the effect of a true 
HALT. Instead, the CPU's Halt Acknowledge 
output line is tied in with the Reset button. The 
result is a READY in Level II and a disastrous 
reboot with an expansion box connected. This is 
another good reason for reasserting the Level II 
reset function with this modification. 
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Up-Front RESET 




The solution to this problem is to disable the 
disk controller whenever disk access is not 
expected. Open the expansion box, and locate 
Z32, near the power switch. If you have a newer 
expansion interface, this circuit will be marked 
Z39. This is a 16-pin circuit, type 74LS155. 
Identify the circuit trace that runs from pin 4 
underneath the IC and out the opposite side. Use 
an ohmmeter if necessary to make sure you have 
the right trace. This signal activates the disk 
controller chip's output to the CPU; when it is 
cut, the keyboard unit cannot 'see' the disk 
controller. 

Take a sharp blade and cut this trace. Solder a 
10K ohm resistor from the far side of this trace to 
pin 16 of Z32 (or Z39). This is the +5 volt lead, 
and will hold the pin high. 

Next run a pair of fine wires from either side of 
the cut trace to each connection of a small toggle 
switch. When the switch is on, the cut trace is 
bridged, and the disk controller buffer can be 
activated normally; when the switch is off, the 
Reset button sends the software to a routine that 
checks for a disk controller. Since it does not 
'see' the controller, it acts as if it were simply in 
Level E BASIC and returns to READY. 

Be sure to mount the switch as close as possible 
to the trace cut, preferably right on the front of 
the expansion box, as shown in Photo 4-1. This 
will prevent noise from creeping in to an already 
somewhat noisy box. 



The LNW expansion interface change would 
normally be identical to that for the Radio 
Shack box, except for the integrated circuit 
numbers. One additional change is necessary. 

The trace from U19 pin 4 leading to U8 and 
U15 is cut, and a 10K resistor wired from the 
trace end closest to U8 and U15 to +5 volts 
(found at U19) pin 16). 

However, the pullup/pulldown resistors in the 
LNW expansion box can still give an 'on' 
reading to the CPU. To avoid this, change the 
pulldown resistors from 220 ohms to 470 ohms 
(or, if they already are 470 ohms, from 470 ohms 
to 680 ohms). This will result in the 'high' 
reading needed to avoid picking up the disk 
controller signal. 

Up-Front RESET 

If you are a frequent user of the Reset button 
in Level II — and once again a user of it with 
your expansion box — then you will want to get 
the button out of the area of the sensitive 
interconnect cable, and well within reach. It will 
be a welcome relief from clawing at the silver 
port cover, or totally wiping out your program by 
jostling the cable. 
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Figure 4-3. Expansion box reset modification. 



Photo 4-3. Expansion box reset modification. 

Visible in this photo are a 1 2-inch replacement expansion cable, 
and the disk-defeat switch to recover the reset function. 
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Figure 4-4. Up-front reset addition. 
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A momentary-on pushbutton (such as Radio 
Shack part number 275-1547) can be added to 
the cover of the keyboard unit. Photo 4-2 shows 
the position of the Reset button on the left side 
of the computer. Run two wires from the 
pushbutton to a small cable connector (a 
submini plug), and run two wires from the Reset 
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Photo 4-4. Up-front reset addition. 

Reset switch added to the top cover. A connector is added so the 
cover can be removed easily. 
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Piggybacking sequence: pins are removed from short solder-tail 
socket, and it is used as a grommet for a wire-wrap socket. After 
this is soldered to the baseboard, a third socket is plugged in 
place. 



button (see Figure 4-2) to the other end of the 
cable connector (a submini jack). The project 
can be completed in ten minutes, carpentry and 
all, and reset will be less frustrating. 

Note : Don't risk being a victim of the Apple 
syndrome! Apple's Reset button is placed much 
too close for comfort to the user's work area, and 
many a program has disappeared into the 
electronic stratosphere when inadvertently 
pressed while typing. So keep that Reset button 
just out of reach! 



Working by the Woodstove 

There comes a time when sitting up straight by 
the computer is no longer fun. Or when the 
neighborhood kids howl because they can't all 
reach the keyboard at once during an action 
game. Or when those kiddie hands are just too 
sticky for your sacred micro. Or, in my case, 
when the computer's room is just too cold to 
share with my typing fingers. That's when you 
need a keyboard and monitor in the room by the 
woodstove. Or an extra keyboard for the 
young'ns. Or a keyboard for the lap in an easy 
chair and a monitor on the mantle. 

The additional keyboard is mostly a matter of 
carpentry, because there's nothing special about 
the TRS-80 keyboard. It's merely a matrix of 
switches, eight by eight. Each position in the 
matrix is identified by the computer's software 
and turned into a character. 

Start by obtaining two high-quality wire-wrap 
integrated circuit sockets, and one good 
solder-tail type. These are 16-pin sockets. You 
will also need fine wire, a 16-wire jumper cable 
with plug attached, and a keyboard. 

The keyboard can be any style you like, from a 
complete alphanumeric keyboard ($40 to $120), 
to a $10 numeric keypad if you work mostly with 
numbers. Whichever you choose, it must consist 
of individual keys, each with a single-pole, 
single-throw (SPST) contact pair. Many small 
calculators have a prearranged matrix which is 
incompatible with the TRS-80. If you choose a 
matrix keyboard, check that it will work with the 
TRS keyboard pattern shown in Table 4-3. 
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Table 4-3. Keyboard matrix. 
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Since depressed keys are identified in software 
by the row and column, you only need to know 
which column-row combinations produce the 
letter you want. That way, you can reassign your 
keyboard's characters for any purpose that suits 
you - including the Dvorak keyboard. Thus, you 
need make no. software modifications to your 
favorite machine language programs to use them 
with different keyboard combinations. 

Furthermore, the attachment of a 64-key 
musical keyboard can open the door to direct 
compiling of music as you play it. 

The physical layout of the TRS-80 keyboard 
unit is fairly compact, leaving only a space on the 
far left or far right for the added keyboard 
connection. I have chosen the left side for that 
addition. Inside the computer, this location is 
directly above a blank part of the keyboard's 
circuit card. 

Use a strong flat screwdriver to snap out the 
black portion of the keyboard cover. Six tabs 
hold it in place at the top and bottom. Mark 
precisely where the free area can be found on the 
baseboard. 

You will be using the three IC sockets to make 
a standoff-style keyboard connector. Pull all the 
pins from the solder-tail socket, and use this 
socket as a guide to drill 16 holes in the 
baseboard. Use a very fine hobby drill — #68 is 
good. When you have the holes, completed, slide 
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The extra keyboard socket is soldered in place, with the gutted 
solder-tail socket used as a grommet 



one of the wire-wrap sockets into the 
disemboweled solder-tail socket, and feed the 
wire-wrap pins through the circuit board. 
Fasten with fast-drying epoxy; do not use white 
glue, as this will react badly with metal. 
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Plastic carriers from flat-pack integrated circuits make excellent 
'bridges' to hold wires in place. A drop of glue holds them there. 

When the glue is set, remove the entire 
keyboard cover, turn the baseboard over, and 
identify pin 1 of the newly installed socket. This 
pin will attach to column one of the keyboard 
matrix (see Table 4-4). On most versions of the 

TRS-80, you can use the keyboard's resistors to 
identify the columns; I recommend this, because 
there were at least three separate runs of 
keyboards, each with a different layout. 



Column 
Column 
Co lumn 
Co lumn 
Column 
Column 
Co Lumn 



RB 
R5 
H3 
RS 
R7 
R1 
R4 
R6 
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B ENTER SHIFT 
9 CLEAR 
: BREAK 
; UPARROW 
, DOWNARROW 
- LEFTARROW 
. RIGHTARROW 
/ SPACE 



Table 4-4. Keyboard column assignments. 

Match column one, then, with socket pin 1; 
column two with socket pin 2; column three with 
pin 3; etc. Solder a separate wire to each of the 
resistors, and wire-wrap or solder the other end 
to their respective socket pins. Make sure you 
solder to the end of the resistors which are 
connected to the keyswitches, not the other ends, 
which are all connected together. 

The keyboard matrix rows are found at the 
input pins of the on-board ICs, but because of the 
many versions of the TRS-80 keyboard which 
have been issued, this sequence is inconsistent. 
The technical manual identifies the rows as 
shown in Table 4-5, but it's better to check for 
yourself. Look for the traces that connect 
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77ie extra keyboard socket is soldered in place, with the gutted 
solder-tail socket used as a grommet 
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Socket rises perfectly to the height of the outer shell Note reset 
button extension at left 




Completed extension cable plugs discreetly into the socket Any 
type of keyboard, from a small numeric pad to a full 64-key 
musical keyboard can be used. 



together @, A, B, C, D, E, F and G. These are all 
in row one. Solder a wire to some point in this 
row, and run it to pin 16 of the new keyboard 
socket. 
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Table 4-5. Keyboard row assignments. 

Locate row two by using Table 4-5, and solder 
a wire from somewhere in this row to pin 15. 
Likewise, identify rows three through eight, and 
solder them to pins 14, 13, 12, 11, 10 and 9, in 
order. When viewed from the top, the pin 
arrangement is as shown in Figure 4-4. 



Figure 4-4. 
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Once the wiring is complete, clip the pins on 
the added socket very short, turn the board over, 
and put everything back in the case. Power up 
and check the operation of the computer. 

Now clip a small length of bare wire about an 
inch long, and bend it in the shape of a 'IT. At the 
newly installed socket, jumper each row across to 
each column, one at a time. You should produce 
all the non-shifted keyboard characters on the 
screen, including the previously inaccessible four 
arrows and the cursor character. 

Clip an additional jumper, and cross row eight 
with column one. This simulates the pressing of 
the SHIFT key. Repeat the column-row 
jumpering, and note that all the shifted 
characters now appear. Any unusual behavior, 
such as repeated letters or groups of unrelated 
letters produced from a single jumpering, 
indicates a wire may be shorted, attached to the 
wrong column or row, or left out completely. 

Finally, as with all modifications, make the 
cosmetics pretty. Snap the black plastic cover 
off again, and in it cut a rectangular hole the size 
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of the 16-pin socket, using a hot, sharp X-acto 
knife or razor blade. Work slowly, filing or 
smoothing, and rub the finished hole with a 
marble. This will result in a professional- 
looking addition. 

The second wire-wrap socket now piggybacks 
into the first one, and the black cover snaps back 
on. The socket should fit perfectly, rising about 
1/16 inch above the surface of the cover. The 
16-wire cable plugs into it a comfortable distance 
from the typing area, well above and to the left of 
the up-arrow key. 

For each keyboard you wish to add, work out 
the row-column matrix using the table. A jumper 
cable may be an integral part of each keyboard, 
or an IC socket'lug arrangment similar to the 
main unit can be included with each added 
keyboard. You can even chain keyboard to 
keyboard by including two sockets on each one - 
just be sure all the sockets and plugs are 
identically wired! 

Working by the Woodstove - II 

Once you've got a new keyboard in your lap, 
you'll probably want a nearby screen to glance 
at. There are two ways to do this: by using a 
video monitor or by using an ordinary television. 



There are advantages and disadvantages to both 
methods. 

A video monitor is the ideal tool because the 
image is crisp and clear, and your TRS-80 
provides a 'composite video' (video with both 
image and synchronization signals) output. But 
a video monitor also costs somewhat more than a 
new black and white television, and means an 
added expense in any case. 

A television on the other hand has limited 
'bandwidth'; that is, it was made for fluctuating 
images, and not for the precise on-off quality of 
white letters on a dark background. If you've 
ever noticed that it's sometimes hard to read 
telephone numbers, addresses, or credits for 
television programs, you've got an idea of how 
hard it can be for some sets to reproduce crisp 
computer lettering. 

Furthermore, most televisions accept only 
radio frequency (RF) input, meaning your 
TRS-80 output has to be converted to RF before 
your television can make sense of it. The last 
complication is that such a close and strong RF 
signal can overload your television's automatic 
gain control (AGC) resulting in an unstable, 
twisting, rolling, or badly contrasted picture. 

But chances are you already have a television, 
and chances are even better that the television is 



Making it Look Manufactured 

One of the worst curses of a customized 
anything is how it tends to look - homemade. 
Now I have absolutely nothing against 
something looking homemade, but whenever I 
do that, somehow it also acts homemade - that 
is, just a bit too eccentric to be reliable as a 
computer! 

Instead, attend to the cosmetic aspects of the 
TRS-80. Since the plastic case is very pliable 
and 'works' easily, these touches are easy. The 
silver coloring is a flake paint, and tends to 
wear off, particularly below the shift keys 
where the typing hands rest. The black plastic 
cover is very soft and can be scratched; its 
pebbled surface makes such scratches stand 
out. 

If the silver flake paint wears off, it can be 
resprayed with the kind of paint used on model 
cars. Work the spray can valve for a while until 
it is spraying evenly, and then spray the silver 
cover from a slight distance. If the color match 
is not perfect, the bottom can be sprayed as 



well. Use two or three extremely light coats for 
a good effect. 

The black plastic cover can even have deep, 
obvious scratches repaired by rubbing it with a 
glass marble. The scratch will smooth over, 
making it different from the area around it. 
Next, pick at the smooth area very lightly with a 
needle, making pebble-size marks similar to the 
rest of the case. Rub with the marble again until 
the scratched area looks exactly like the 
surrounding area. It really works. 

When cutting holes for switches, buttons, 
sockets, jacks, keypads, etc., always cut the 
holes slightly smaller and use rattail (for round 
holes) or triangular (for rectangular holes) file to 
expand it to the correct size. This way, no 
unsightly cut marks will extend away from the 
area of the modification. Bevel cut rectangular 
surfaces with a flat file, smooth them with a 
letter opener or librarian's 'bone', and touch up 
the corners. The result will be almost precisely 
like, the manufacturer's molded cutouts. 
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Figure 4-5. Extra video jack 




Photo 4-7. RF modulator hookup. 



Additional jacks added in order to feed both the video monitor 
and an RF modulator installed in the expansion box. 
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Photo 4-6. Extra video jack. 

just where you were thinking of using your 
computer. 

Before going on with these modifications, 
there is one important note. Working with any 
unknown television or monitor can crash your 
system if it is electrically noisy. If you plan to 
send a video signal directly to a monitor, or 
especially to a television modified for video 
input, make sure the set isn't 'hot' - no AC line 
voltage should be floating on the case. This can 
damage your computer ... or you! If you are 
considering a monitor or direct video input, and 
you are not familiar with your video sets, then 
take the television or monitor to a service person 
who can check them out. With appliance devices 
such, as ordinary televisions, this is doubly 
important. This note does not apply if you will 
use RF input to a television. 

Whichever method of added video you decide 
upon, though, there is a solution. The first and 
easiest is to add an extra video output jack to 
your computer. There's plenty of video signal to 
be had, and it can be shared among several sets. 
Figure 4-5 shows how to wire that extra jack, 
and Photo 4-6 shows how mine is installed. The 



Figure 4-6. RF modulator hookup. 
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Hexadecimal Keypad 




connector shown in the photo is a miniature 
Amphenol connector used for microphone cable, 
although any kind of microphone, video, CB, 
phono, or other shielded coaxial cable and 
connector can be used. 

A second approach is to send the computer's 
video signal to an RF generator, and feed that to 
your television. An RF modulator is available in 
kit form from Radio Shack (part number 277- 
122, with TRS-80 installation instructions) and 
also from other suppliers. A few plugs and jacks 
are needed to complete the job. 

Assemble the kit or purchase a surplus 
modulator, and hook it to an ordinary television. 
Either run the new video output to the 
modulator's input (use the directions with your 
modulator), or install a separate DIN 
plug-and-jack pair as in Photo 4-7.). 

Actually modifying an ordinary television for 
video input is tricky, and I won't cover the topic 
here. If you are interested in doing this — and 
picture quality will be very much improved — 
refer to Don Lancaster's TV Typewriter 
Cookbook. 

The results of your video modifications will be 
dependent on how clean your soldering is, the 
layout of your wiring, etc. If you add the RF 
modulator, you may notice something similar to 
herringbone on your TRS-80 monitor if the 
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Photo 4-8. An Extra system near the woodstoue. 

The kitchen installation. An old RCA television and a surplus 
keyboard make working with the TRS-80 more convenient 
Computer remains in one place, but extra monitor and keyboard 
can be moved closed to the woodstove on cold days. The 
woodstove offers no electronic interference. 



contrast is turned all the way up. Move the 
modulator away, or put it in a shielded (all metal) 
box, and the herringbone will disappear. 

If you use a long cable directly from the video 
output, there will be a huskiness to the characters 
on your TRS-80 monitor. This is actually a kind 
of 'smearing' introduced by the capacitance of a 
long cable. This is not bothersome to me; in fact, 
it actually seems to improve the clarity and 
boldness of the screen characters. 

Finally, if your RF-input television addition 
results in an unpleasant display on the TV, try 
to adjust the automatic gain control (AGC) on 
the back of the set. Tune it in carefully as well. 
There will probably be less clarity in the 64- 
character mode than you are used to with your 
monitor, unless you have a very good set. 

Hexadecimal Keypad 

Entering machine language programs using 
T-Bug or another monitor is tedious enough 
without having to search all over the QWERTY 
keyboard for hexadecimal numbers. Instead, a 
keyboard can be added right onto the TRS-80. If 
you have a numeric keypad included with your 
Level II unit, you might want to remove it to add 
this one. 

The addition of a hexadecimal keypad is 
mostly carpentry, since the connections are made 
in parallel to the main board, exactly like those 
connected to the socket addition described 
earlier. An unencoded hexadecimal keypad to do 
the job is available from Jameco Electronics (see 
Appendix 1. ), and one of its keys can be set aside 
for an Electric Pencil or other control key, 
adding significant programming power to your 
custom TRS-80. 

For this modification, you will need two 10- 
inch strips of 1/2-inch by 1/2-inch plastic rod 
(plexiglas or lucite are best, but wood strips will 
work as well), five-minute epoxy, wire, and the 
notorious hot razor blade and marble for the 
cosmetics. 

Undo the cabinet as usual, and take the entire 
electronics out of the case. Later TRS-80's have 
an on-board, two-chip Level II ROM set, but if 
your Level II ROMs are the type on a separate 
board fastened to the end of an interconnect 
cable, then they will have to be moved. They are 
fastened to the bottom right of the circuit card 
with double-face tape; slit the center of the tape 
with a razor blade. Do not pull the ROM board 
off by force, as the pressure might crack either 
circuit board. 
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Photo 4-10. 
template. 



The interconnect cable to the ROMs is long 
enough so they can be remounted inside one of 
the case 'feet', or above the hexadecimal keypad. 
Pick up a small piece of double-face tape to 
refasten them, or roll masking tape into cylinders 
(remember hanging pictures in fourth grade?). 

The Jameco Electronics keypad base is 
identical to the TRS-80's in height and depth, so 

Black plastic cover used as 







the two plastic strips can be used to create a 
'trailer hitch' arrangement with the smaller 
keyboard. Support both boards firmly so that 
they are parallel and the hex pad meets the 
TRS-80 printed circuit base. Cement the plastic 
strips in place with the quick-setting epoxy, and 
make sure the vertical alignment of both 
keyboards is identical. If you have a later style 
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Photo 4-10. Black plastic cover used as template. 

The black plastic keyboard cover can be snapped out and cut to 

fit A paper template is used first to verify the position of the hex 

keypad. 



Cleaning the Keyboard 

If your TRS has the old-style keyboard that 
was badly afflicted with keybounce, there are 
many ways to take care of it other than 
perennially loading a KBFIX routine. 

The first rule is to make sure you have the 
old style keyboard! The newer keyboards have 
a sculptured curve to their arrangement when 
viewed from the side. These new boards have a 
contact arrangement which can be destroyed by 
trying to remove the keycaps. But these 
keyboards don't have a keybounce problem 
anyway. 

Bend a paper clip into an ingenious keycap 
lifting tool, like this: 
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Figure 4-7. Keycap lifting tool 

Slip this clip underneath a keycap, and lift 
up. The plastic cap will come off, revealing a 
hole in which two metal plates are protruding 
upward. 



I 



Keyboard is attached with runners to the main keyboard, and 
glued in place with epoxy. 



The best way is to test the keys. Press each 
key quickly, gently, slowly, or sharply, until you 
decide whether it is a 'bouncy' key. If it still 
bounces after the cleaning, then take a hatpin 
(are there still hatpins?) or heavy sewing 
machine needle, and push the tines in line. 
This is a very delicate job; use caution and a 
magnifying lens. If the plates are not parallel 
to each other, or if they are vertically 
misaligned, use the pin to shift their positions. 

The villians are dirt and bent tines on the 
plates. Brush out the dust, dirt, or hair (or much 
better, blow it out, using photographers' 
compressed air, such as 'Dust-Off). You will be 
amazed at the cloud of grit that rises from the 
keyboard. Next, examine the tines of each key 
very carefully. They should be perfectly in line, 
so that when a key is pressed, all come into 
contact with their opposite (un-tined) plate. 

Check all the keys for bounce again, and 
work until it is completely cured. Some folks 
recommend a spray of contact cleaner at this 
point; I recommend against it. The cleaner 
tends to stay wet for a while, and dust and grit 
can get back into it very quickly, collecting into 
a dusty mudpile. Instead, give all the keys a 
last brushing or spraying with compressed air, 
and fit the keycaps back on. 

Keybounce should be gone for quite a while. 
Monthly cleaning will keep the keyboard in 
shape. 



The Custom TRS-80 
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keyboard (with the curved keyboard array), you 
will have to adjust the carpentry slightly. You 
may also experience a bit of keybounce on the 
new keyboard unless you keep the keys clean. 

When the glue has set, use the black plastic 
cover as a template for drawing your current key 
positions and, with the aid of a straightedge, 
draw extension lines horizontally across that 
drawing. These are the upper and lower limits of 
the new keypad opening. Align the template with 
the complete alpha/hex keyboard assembly, and 
mark the vertical positioning of the hex keys, 
allowing about 1/32 inch additional on both sides 
for key-travel room. This will bring you within 
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Back of keyboard is wired by soldering directly to the key pins. 
Wires are then run to resistors and integrated circuits found on 
the main keyboard. 



1/4 inch of the power LED. 

Using the template with the black plastic 
cover, carefully cut an opening in the cover with 
the hot razor blade. This is the most 
time-consuming task, and should be accurate 
enough for the keys to travel easily (fit it atop the 
keyboard before re-installing the modified 
computer), and should look factory-finished. 

It's about time to interconnect the wires from 
the hex pad to the main keyboard, but before 
that, you'll probably want to rearrange the 
keycaps on the hex pad. Using the lifting tool, 
pull off the keycaps and put them in a convenient 
order for hex entry; I used the accounting 
arrangement, bottom to top. This is the pattern 
used for the wiring arrangement shown in 
Diagrams ■ 4-1 and 4- 2-. 

Rest the keyboard on its face, and separate it 
gently from the main circuit card. Set the 
keyboards in an accessible position, and solder 
fine wires (wire-wrap type is easiest to use) to the 
hex pad connections shown in Diagram 4-1. 
Route the individual wires from the hex keys to 
the points on the circuit card shown in Table 
4-5. As before, check to make sure this IC 
arrangement matches your board. 

Next, solder wires to the hex pad contacts as 
shown in Figure 4- 1 , and route these wires from 
the hex keys to the circuit card's resistors noted 
in Table 4- 4. Double check these too against 
your version of the keyboard. Once both sets of 
wires have been run, gather them in neat hanks 
and fasten them along their routes with wire ties 
(plastic bag ties will also work well). 
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Completed keyboard seats easily in the case bottom. A piece of 
insulating plastic should be inserted under the added keyboard 
to prevent pushing the keyboard pins into the main circuit board 
and causing a short 
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DIAGRAM 4-1 
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Reassemble the keyboard in its case, 
remembering to orient the Level II ROM board 
safely in its new position. Reinsert all cables, and 
restore power. The keys on the main keyboard 
should respond normally; check them all. Now 
check the keys on the hex pad. All but the 
bottom right one should have an effect. To test 
its operation, enter this program: 



:a£j 



10 CLS 

20 PRINT PEEK 1144641; 

3D GOTO 20 
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Level II ROM board can be fit immediately above the hex pad 
Insulating double-face tape can be used to hold them in place. 



The value you read should be zero unless either 
the shift key on the main board or the bottom 
right hand key on the hex pad is depressed. The 
shift key will return a value of 1; the new key will 
display a value of 16. Pressed together, they will 
read 17. 

All keys should now be working properly. As 
with the socket addition described above, 
problems will occur in the form of incorrect 
letters, groups of letters on a single keypress, or 
dead keys. If any of these symptoms appear, 
recheck for shorted or unconnected wiring, or a 
difference in your model TRS-80 keyboard. 
Refer to Tables 4- 3 through 4- 5 if you suspect 
the latter. 



The final modification with black plastic cover fit back in place 
looks manufactured (almost). 
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Reversing the Video 

The video display of most computers including 
the TRS-80 suffers from a tremendous flaw - 
contrary to what we have known since we first 
learned to read, the letters are presented to us in 
glowing blue-white on a black background. 
Serious use of a computer as a day-to-day 
appliance, as a true adjunct to our daily lives, is 
limited by its formidably unappealing, tiresome, 
and illegible display. 

The reverse video modification is surprisingly 
easy, so the question arises: why is it not a 
standard feature of small computers? The 
answer is found partly in a tradition of computer 
monitors which have always been lighted 
characters on a dark background. The 
remainder of the answer is found in the video 
display itself, which is more often than not 
incapable of presenting a legible character in the 
black-on- white mode. 

This problem arises with the TRS-80 as well; 
the video monitor has weaknesses which are 
emphasized by reversing the characters. But 
overall, and with a small change to the monitor 
itself, the display can be made quite legible and 
easy on the eyes. 

For this modification, you will need three 
integrated circuits: 74LS02, 74LS74, 74LS368. 

A 1.5K-ohm resistor will also be used, and wire- 
wrap wire for the interconnections. There are 
two ways of making this modification: on a 
separate board, or piggybacked atop chips 
already present inside the TRS-80. Since the 
latter approach would involve at least 15 
separate wires, both this change and the high- 
speed modification presented below will use the 
piggyback system. 

Open the computer's case, and remove the 
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Normal screen has unnatural bright characters against a dark 
background, which is wearying on the eyes. 



electronics so the integrated circuit side of the 
main card is up. Locate the following circuits 
(the numbers are silkscreened on the board): 
Z22, Z26, Z27, Z30, Z52, Z53, Z54, and Z59. 

The output of Z54 (pin 8) is a decoded signal 
representing ports 254 and 255. Combined 
directly with the output of Z52 (pin 6), port 255 
is selected for use by the cassette and video 
circuits. By inverting the output of Z52 and 
combining it with the output of Z54 and the 
computer's OUT signal (Z22, pin 3), port 254 
can be selected. Figure 4-8 is the schematic for 
this complete decoding process. 

The decoder uses the 74LS02. Prepare the 
integrated circuit by bending all the leads 
except pins 7 and 14 so that they are parallel 
with the IC's body. Locate Z53 on the TRS-80. 
Seat the 74LS02 directly atop Z53, with both 
notches or dots facing in the same direction. 
Solder power pins 7 and 14 of the piggybacked 
IC to corresponding pins 7 and 14 of the one 
below. I will refer to this piggybacked IC as 
ZPORT. 



Figure 4-8. Reverse video schematic. 
Z41 6 O 



Z59 5 
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Find Z52. Run a wire from pin 6 of Z52 to both 
pins 2 and 3 of ZPORT, and solder it. Next locate 
Z54. Solder a wire from its pin 8 to pin 11 of 
ZPORT. Finally run a wire between pins 1 and 
12 of ZPORT. 

As mentioned, Z22 contains the needed OUT 
signal. Run a wire from pin 3 of this circuit to pin 
5 of ZPORT. Solder together pins 8, 9 and 13 of 
ZPORT, and run a wire between pins 6 and 10 of 
ZPORT. Pin 4 remains unused, and it contains 
the complete decoded signal of port 254 as shown 
in Figure (?). The BASIC command OUT 254,N 
will activate this signal. 

The next IC to be prepared is the 74LS74. 
Again, bend all leads parallel to the body except 
7 and 14, seat this upon Z26, and solder the 
power pins (7 and 14) in place. This 
piggybacked circuit I will call ZFLOP, as it will 
determine which state (normal or reverse video) 
is flip-flopped into place when OUT 254,N is 
commanded. 

Run a wire from the decoded signal at pin 4 of 
ZPORT to pin 11 of ZFLOP. Z59 has a 
convenient data line (bit 1) at its pin 5; run a 
wire from there to pin 12 of ZFLOP. Now run 
short wires connecting together pins 10, 13, and 
14 of ZFLOP. With these connections made, 
OUT 254,0 will flip the circuit, and OUT 254,2 
will flop it. (Is the suspense building?) 
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Photo 4-11- Reverse video screen example. 

Illuminated background with dark characters is clear and, 
together with a green screen of some type, much more gentle to 
look at over long periods. 



The final IC is now prepared. Bend the leads 
of the 74LS368 parallel to its body, except for 
pins 8 and 16. Seat this on Z27 and solder power 
pins 8 and 16 to it. For convenience, this 
piggybacked circuit will be called ZMODE. 

Find Z30 and Z41. Pin 1 of Z30 is connected via 
a circuit board trace on the underside of the 
board to pins 6 and 7 of Z41. Z30 provides the 
characters to be output to Z41, which is part of a 
circuit that mixes in the synchronization 
information to produce 'composite video'. Cut 
this trace near Z30. 

Why cut this trace? The TRS-80 produces 
characters on the screen by turning on 'dots' as 
the electron beam sweeps across the tube. Each 
dot is part of a continuous stream of pulses which 
might be called 'dots' and 'undots' - ones and 
zeros. To reverse the video, then, all you need to 
do is to turn the 'dots' into 'undots', and turn the 
'undots' into 'dots'. We insert an electronic fork 
in the road at the output of Z30. When directed 
toward one side of the fork, the characters are 
made up of dots; when directed down the other 
fork, the characters become undots, and the 
background becomes dots. 

Run a wire between pin 1 of Z30 and pins 2 and 
14 of ZMODE. These are two inputs of an 
inverting buffer, the 'fork in the road'. If we 
invert the signal once, the video reverses . . . 
invert it twice, and the signal returns to normal. 
Connect pins 3 and 4 of ZMODE together to 
perform the double inversion. Pin 5 is the normal 
video output, and pin 13 becomes the reversed 
output. Connect both these outputs (pins 5 and 
13) together. 

Find the opposite side of the broken trace from 
Z30, and follow it to a hole that is plated through 
the board; it is at the end of a row outlined by Z29 
and Z30. Be careful to select the correct hole. 
Run a wire from this hole to pins 5 and 13 of 
ZMODE. This connection feeds both normal and 
reverse video back into Z41 and through to the 
video output jack. 

I have chosen ZMODE because it is a three- 
state circuit. That is, its outputs can be made 
electronically invisible. Otherwise, both normal 
and reverse video would be output at the same 
time. To choose between them, ZFLOP is used 
to enable one or the other of those outputs. Run 
a wire from pin 8 of ZFLOP to pin 15 of 
ZMODE. Run a wire from pin 9 of ZFLOP to 
pin 1 of ZMODE. 
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By commanding OUT 254,2 or OUT 254,0, 
data line 1 selects which output of ZFLOP will be 
enabled, and which video mode will be visible on 
the screen 

Check your wiring and restore the computer to 
its case. Power up, and command OUT 254,2. 
The screen will reverse. The effect, alas, will not 
be as dramatic as you might expect because the 
video monitor is not a great piece of work. 

Power down the system, unplug the monitor, 
and open it up. You might find that a hex-nut 
driver is necessary to open the monitor intead of 
a Phillips type; later monitors used 1/4-inch hex 
nuts. 

When it is open, find the plug-in circuit card 
closest to the monitor wall (some have only one), 
and locate the resistor marked R14. The present 
value should be 3.3K ohms (orange, orange, red, 
silver or gold). We want to give the video signal 
a bit more 'oomph', so piggyback the 1.5K ohm 
resistor atop R14 and solder it in place. Restore 
the cabinet. The reverse video modification is 
complete. 
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Photo 4-9. Two photos (a) & (b) of two keyboards. 



Clumsy? Me Too. Do This First. 

During the course of these modifications, 
there will be connections made to integrated 
circuits which are carrying piggies atop their 
back. In base your soldering iron is a bit obese, 
you might want to solder wires to these circuits 
in advance. 

All these pins will have wires running to 
them: 

Z22, pin 3 

+Z25, pins 11, 12 and 13 

+Z27, pins 4 and 5 

Z30, pins 1 and 13 

Z41, pin 6 

Z52, pin 6 

Z54, pin 8 

Z59, pin 5 

Z60, pins 4 and 5 

Z63, pin 12 

Only those marked with a plus sign (+) 
actually carry piggies, but since everything is 
close together, you might want to make all the 
connections in advance anyway; so there they 
are. 
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Lower Case with Upper 

Many modifications have been proposed to 
obtain lower case characters already present in 
the TRS-80 character generator. Some are 
incompatible with each other, although they do 
provide access to a group of special control 
characters also burned into the character 
generator. 

The modification provided here is simple, 
compatible with both the Radio Shack and 
Electric Pencil modifications, and should give no 
grief throughout its life. For this modification 
you will need a single integrated circuit, and 2102 
AN-4L memory chip. These chips are available 
from several suppliers; in a pinch, the 21L02 sold 
by Radio Shack will do the job. 

The 2102 will be piggybacked - except for pins 

11 and 12 - atop Z45, also a video memory chip (it 
will not necessarily be marked a 2102, since 
Radio Shack ordered house numbered parts for a 
while, but it is a 2102). Bend pins 11 and 12 of the 
piggyback 2102 parallel with its body, and fit the 
integrated circuit on Z45, making sure it is 
positioned in the correct direction. Solder 
extremely carefully, pin for pin, down one side 
(pins 1 to 8), and up the other (pins 9 to 10, 13 to 
16). 

Now locate Z25. It is an integrated circuit 
containing four OR-gates, one of which is not 
used. With solder-wick, suck up the extraneous 
solder that is present on pins 11, 12, and 13, and 
with a sharp X-acto knife or razor blade, cut pins 

12 and 13 free from each other and from the 
ground lead going to pin 7. 



Finally, run four wires: from Z60 pin 4 to 
piggy-Z45 (call it ZMEM from now on); from 
Z60 pin 5 to Z25 pin 13; from Z30 pin 13 to Z25 
pin 12; and from Z25 pin 11 to ZMEM pin 11. 

The lowercase modification is complete. A 
memory chip to represent the missing bit 6 has 
been added, and the necessary triggering 
information (bit 7 and bit 5) has been gated 
through Z25. Why is it necessary to gate bits 7 
and 5 to trigger ZMEM? Because the 
information sent by Radio Shack's print routine 
does not include bit 6; in an unmodified 
machine the bit is generated by the presence of 
bit 7 and bit 5! Check the Technical Reference 
Handbook for details. In this case, the false bit 6 
is generated where necessary by Z30, and ORed 
with a true bit 6. In other words, either case will 
result in bit 6 being embedded in the new bit 6 
video RAM, ZMEM. 

Note: Several TRS-80's in which I have 
installed this modification contained a Z25 
with the spare gate dead. Perhaps it was a 
Radio Shack economy move. If so, piggyback 
a 74LS32 on Z25, soldering pins 7 and 14 to 
Z25, and continue with the remaining 
lowercase mod instructions. 

The lowercase modification can be tested as 
follows; a complete lowercase driver is presented 
in Chapter 3: 



10 GLS 

20 FOR X = 1S360 TO 15360+255 

30 POKE X.Y 

40 Y=Y+1 

50 NEXT 

60 GOTO B0 



Now locate the trace on the circuit board 
running from Z60 pin 4 to Z30 pin 13. Use an 
ohmmeter if necessary to make sure you have the 
correct trace. Cut it through. Double check that 
you have not cut the trace that runs from Z60 pin 
4 to Z27 pin 13. 
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Figure 4-9. Upper/lowercase schematic. 
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One by One 



Reversing individual characters is similar to 
the process of reversing the entire video screen, 
except that the reversal is carried out only for a 
short period of time. That period is determined, 
of course, by the letters being displayed. (At 
this point, I should note that all four internal 
hardware modifications in this chapter are 
partly interrelated. Both reverse video and 
high-speed modifications use the same output 
port decoding; both reverse video and reverse 
characters use the same flip-flop; both reverse 
characters and upper/lower case use the same 
video memory decoding hardware). 

Before installing the individual-character 
reverse video, the upper/lower case modification 
must be installed. This will provide the 
essential bits 6 and 7 (see that section for an 
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explanation of the 'phantom' bit 6). For the 
individual character reverse, three additional 
integrated circuits will be needed: one 74LS86 
Exclusive-OR gate, one 74LS10 triple-input 
NAND gate, and one 74C04 hex inverter. The 
last is very important, because it is used for 
aligning the reversal pattern with the letter to be 
reversed. You will also need a small variable 
resistor (trimmer potentiometer, or 'trimpot'), 
approximately 50,000 to 100,000 ohms; two 
capacitors, one 330 picofarads (pF) and one 
0.033 microfarads (mF). 

As before, bend all pins of the 74LS86 except 
pins 7 and 14 parallel with the body of the 
integrated circuit. Affix the 74L886 atop Z24, 
and solder power pins 7 and 14 to it. This gate 
will multiplex the combined bit 6/7 signal with 
the output of ZFLOP (from the previous 
complete reverse video modification). Call this 
gate ZMUXX. 

Remove the wires attached to the outputs 
(pins 8 and 9) of ZFLOP, and run them, 



respectively, to pins 2 and 5 of ZMUXX. Now 
run a pair of wires from pins 6 and 3 of ZMUXX 
to pins 15 and 1 of ZMODE (which were just 
disconnected from ZFLOP). In other words, 
ZMUXX has been inserted between ZFLOP and 
ZMODE. 

Next position the 74LS10 correctly atop Z25 
and solder the power pins in place. Call this 
circuit ZBITS, because it will evaluate which bits 
of given letters should cause the reversal to take 
place. 

The steps below summarize all the activities to 
complete this modification; some have been done 
already, (such as the lowercase modifications) 
but are included for clarity: 



Break trace from Z30, pin 13 to Z60, pin 

Break trace from Z63, pin 12 to Z42, pin 13. 
Break trace from Z42, pin 12 to Z27, pin 4. 
Cut loose Z25 pins 11, 12, 13, from pin 7. 



Carpentry Considerations 

When you first open your TRS case, you'll 
probably be unfamiliar with what comes out. 
The photo below is presented to remind you 
that six screws and five white spacers make up 
that group: 
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Photo 4-12. Screws and spacers in keyboard unit 

When you have been soldering in and around 
the circuit board, chances are that a lot of ugly, 
crusty brown flux residue will build up. In 
order to see what you are doing and make sure 
connections are sound, you should clean this 
mess. There are flux removal compounds 
available, and these should be applied with 
cotton swabs. 



My own choice is a gentle but very fast acting 
substance which can sometimes be found in 
surplus - Thermo-Fax brand belt cleaner. This 
treats the boards and their coating without 
harsh chemical action, but removes the flux 
within seconds. 

Another area of difficulty in doing these 
modifications is cutting traces. Place the circuit 
board on a very secure and stable table, 
cushioned just a little with a towel. Lean firmly 
but gently on the board, and move an X-acto 
knife or single-edged razor blade back and forth 
until the trace gives way. This may take as 
many as 20 or 30 scrapings. 

When the trace looks cut, make sure. Cut 
deep into the fiberglass base so you can see a 
cut space, and then wipe the area clean with 
flux or tuner cleaner so the break is obvious. 

If you must resolder a trace, scrape the green 
masking from both sides of the cut, wipe it 
clean, and flow solder on both sides, but don't 
bridge the trace with solder. Instead, take a 
piece of bus wire or stripped wire-wrap wire, 
form it into an 'L' shape, and solder the base of 
the L across the trace. Then cut off the excess. 
Bridging with solder alone is dangerous because 
it can look fine, but really be attached only by a 
glob of flux, or be attached so weakly that 
flexing the board will crack the solder off. 
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5. Piggyback on Z45 a 2102, soldering pins 1, 2, 
3, 

4, 5, 6, 7, 8, 9, 10, 13, 14, 15 and 16. 

6. Piggyback on Z24 a 74LS86. 

7. Piggyback on Z25 a 74LS10. 

8. Piggyback on Z6 a 74C04. 

9. Run a wire from Z60, pin 5 to Z25, pin 13. 

10. Run a wire from Z30, pin 13 to Z25, pin 12. 

11. Run a wire from Z25, pin 11 to Z45piggy, 
pin 11. 

12. Run a wire from Z45piggy, pin 12 to Z60, 
pin 4. 

13. Run a wire from Z45piggy, pin 12 to 
Z25piggy, pin 1. 

14. Run a wire from Z63, pin 12 to Z25piggy, 
pin 13. 

15. Run a wire from Z25piggy, pin 2 to Z27, pin 
5. 

16. Run a wire from Z25, pin 12, to Z6piggy, 
pin 1. 

17. Connect together Z6piggy, pins 2 and 3. 

18. Attach one terminal of the 100,000-ohm 
trimpot to 

Z6piggy, pin 4. 

19. Attach the other terminal of the 
100,000-ohm 

trimpot to Z6piggy, pin 5. 

20. Attach one end of the 330-pf capacitor to 
Z6piggy, pin 5. 

21. Connect together Z6piggy, pins 6 and 13. 

22. Attach the other end of the 330-pf 
capacitor to 

Z6piggy, pin 12. 

23. Attach one end of the 0.033-mf capacitor to 
Z6piggy, pin 12. 

24. Attach the other end of the 0.033-mf 
capacitor 

to Z6piggy, pin 11. 

25. Connect together Z6piggy, pins 9 and 10. 

26. Run a wire from Z6piggy, pin 8 to Z24piggy, 
pin 1. 

27. Connect together Z24piggy pins 1 and 4. 

28. Run a wire from Z63, pin 12 to Z25piggy, 
pin 3. 

29. Run a wire from Z42, pin 12 to Z25piggy, 
pin 4. 

30. Connect together Z25piggy, pins 5 and 14. 

31. Run a wire from Z25piggy, pin 6 to Z27, pin 
4. 

32. Disconnect the wires running from ZFLOP 
pins 8 

and 9 to ZMODE. 

33. Run the wire from ZFLOP, pin 8, to 
Z24piggy, pin 2. 



34. Run the wire from ZFLOP, pin 9, to 
Z24piggy, pin 5. 

35. Run a wire from Z24piggy, pin 3 to 
ZMODE, pin 1. 

36. Run a wire from Z24piggy, pin 6 to 
ZMODE, pin 15. 



The modification is complete. Using the 
individual reverse video is not the easiest 
process, but works nonetheless. Printing 
CHR$(0) through CHR$(31) results in control 
codes being acted upon; CHR$(32) through 
CHR$(127) now produce the full range of ASCII 
letters; CHR$(128) through CHR$(191) produce 
graphics characters; and CHR$(192) through 
CHR$(255) produce the 63 possible TAB 
positions. 



To use the individual character reverse, then, 
you cannot PRINT the CHR$ value. Instead, 
you must POKE the value onto the screen. 
Granted, this is a pain, but when a program is 
completed, the prompting can be extraordinarily 
effective. Besides, it's not that hard. Try this: 



10 CLS : Y=15360 
20 FOR X = TO 255 
30 POKE Y,X 
40 Y=Y+1 
50 NEXT X 
60 GOTO 60 

Listing 4-1. Individual character test program. 

Chances are that a group of reversed 
characters appeared, but the reversal band 
didn't match up with the actual characters. 
That's the reason for the 74C04 and the 
100,000-ohm potentiometer. Run the following 
test program: 



10 CLS 

20 FOR X = 16040 TO 16060 

30 POKE X,255 

40 NEXT 

50 GOTO 50 



Listing 4-2. Individual character alignment program. 

Now adjust the potentiometer until the 
crosshatches are centered precisely within the 
white band (or rather, so the white band is in the 
correct background position). 
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Complete font of reversed characters. Because only 64 characters 
remained in the available set, upper and lower case were chosen 
as opposed to numbers and symbols. 



That is a simple example of the individual 
character-reverse process, using BASIC. By 
using ordinary displa routines in machine 
language programs, the individual character 
reverse is an entirely trivial matter, but really 
putting it to work in BASIC requires a bit of 
fancier footwork. 

Using it through BASIC can be done without 
POKEing large numbers of characters in 
prearranged locations. Instead, the position of 
the cursor on the screen can be determined, and 
the characters POKEd in place from there. The 
subroutine below is useful: 

10000 X = PEEKU6416) + 256*PEEK[16417) : RETURN 

This subroutine determines the position of the 
cursor and assigns it to X. Then characters may 
be POKEd as follows: 



40 G0SUB 10000 

50 A$ = "THESE ARE REVERSE LETTERS" 

60 FOR N = 1 TO 25 

70 a = ASC [MID$ IA$,N,1]J 

SO POKE x,a 

90 NEXT 

100 G0SUB 20000 



Listing 4-3. Individual reverse demo program. 

The GOSUB 20000 executes the following 
one-line subroutine: 

20000 ZH = FIX (X/256) : ZL = X-ZH*256 : 

POKE 1641 6, ZL : POKE 1641 7, ZH : RETURN 



This short routine restores the cursor position 
after the POKEs have taken place. There are two 
very important things to note: 

1. If the POKE is to take place on the last 
line of the screen, make absolutely certain 
that the value of X does not exceed 16383, 
because this will POKE nasty values into 
BASIC vectors beginning at 16384. A test 
for X greater than 16383 can be made so: 



10005 IF XM6383 THEN X=96383 
: PRINT : RETURN 



GOSUB 20000 



This will have the effect of restoring the 
cursor, printing a carriage return, and 
finishing the text to be printed. 

2. The POKE feature does not include a 
carriage return, so this method of printing a 
reversed message has the effect of a PRINT; 
(PRINT semicolon) statement. Immediately 
follow the return-from-subroutine with a 
PRINT statement if the rest of the message 
is to be printed on the next line. 

A few peculiarities may arise with this 
modification; among them: 

1. The 'fill' character of Electric Pencil may 
change. This is because any program 
defining graphics characters as 192 to 255 
instead of 128 to 191 is not using them 
according to the original Radio Shack 
specifications. 

2. Single reversed letters scattered 
throughout text may not work. This is due 
to the extremely fast requirements of the 
circuit, and the fact that certain integrated 
circuits may not be up to it. Two characters 
together, however, will print properly. 

3. The timing is so crucial that temperature 
may offset the image slightly. Use 
polystyrene or polycarbonate capacitors, 
never ceramic disc capacitors, for this 
modification. 

4. With a screen full of reversed letters, 
some increase of the brightness control may 
be needed. 

5. The full character set is not available 
because more hardware would be necessary 
to obtain the logic information necessary to 
select out, for example, letters and numbers 
or letters and symbols. 

Although it sounds like I am doing a lot of 
warning about the limitations of this sort of 
modification, you should realize that the TRS-80 
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Photo 4-13. Individual reverse screen example. 

Reverse lettering provides an emphasis; flashing from one to the 

other is extremely effective for prompts. 

was never meant to do this sort of thing, and the 
fact that it does work is remarkable. Once it is in 
place, you will wonder how you could have 
created reasonable self-prompting programs 
without it. See Photo 4-13 for proof of the 
impressive results. 

A complete circuit containing the reverse 
video, upper/lower case, and individual reverse 
video modifications appears in Figure 4-10 , 
below: 



Stepping on the Accelerator 

When you first unpacked your TRS-80 and 
tried a few calculations and displays, you were 
likely amazed at the speed with which the 
TRS-80 was able to respond. But certainly as you 
used the machine, you realized that it could 
spend quite a while performing complex tasks. It 
was then that you joined the ranks of the dozens 
of thousands of micro users searching for a faster 
running computer. 

When the TRS-80 was designed, the options 
for higher speed were put in place. Normal and 
200 percent speed options were right there on the 
circuit board, and 150 percent speed required the 
routing of but a single circuit trace; yet the final 
design opted for the lowest speed (1.77 MHz). 

This modification releases the permanent 
connection of the 100 percent (1.77 MHz) clock 
and allows the computer to switch back and forth 
between this clock rate and a rate 
one-and-one-half times faster - 2.66 MHz - or 
two times faster - 3.55 MHz. There are a few 
pitfalls, but the actual modification is a simple 
one. For it, you will need the decoded port 254 
explained in the reverse video section of this 
chapter (74LS02), the other half of the flip-flop 
(74LS74), and one 74LS367. 
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Figure 4-10. Complete video modifications schematic. 
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Before you perform this modification, there 
are a few things you should know. For a reason 
which I have yet to determine, some Level II 
machines with the two-chip ROM set will not 
accept a speed-up successfully, though most 
will. Second, later units have been 
manufactured (or earlier units may have been 
retrofitted) with a small board known as 'XRX 
HI', a synchronous, 500-baud wave shaper. 
Cassette load at the 750- and 1000-baud rates 
will not work unless the modification is 
deactivated (for details on the cassette system, 
see the Supplements to Chapters 3 and 6). 

The third item concerns the expansion 
interfaces manufactured since January 1980. 
Unfortunately, these interfaces must also be 
modified to accept a higher-speed CPU. But this 
modification (see Chapter 5) is quite simple and 
very reliable. Finally there is the question of 
memory speed. If your TRS-80 is very early and 
the 16K RAMs were shipped with the unit, there 
is a small chance that one or more of these RAMs 
will not be capable of running at 3.54 MHz -- and 
an even smaller chance of not operating at 2.66 
MHz. 

That said, I'll turn to the modification itself. 
Locate Z56 on the circuit board. Cut the foil 
trace that leads from this pin to the hole that is 
plated through the circuit board. Mark that hole 
for future reference. By cutting this trace, you 
separate the 1.77 MHz output of Z56 from the 
clock input of the Z80 processor. 

If you have not created the port 254 decoding 
used in the reverse video modification, you will 
need to piggyback a 74LS02 on Z53. Bend all the 
leads except 7 and 14 parallel with the body of 
the IC, and seat it atop Z53 with the notch or dot 
pointing in the same direction as the rest of the 
integrated circuits on the board. Solder pins 7 
and 14 to Z53; this piggybacked circuit will be 
called ZPORT. 

Locate Z52; run and solder a wire from pin 6 to 
pins 2 and 3 of ZPORT. Find Z54. Run and 
solder a wire from pin 8 of Z54 to pin 11 of 
ZPORT. Pins 1 and 12 of ZPORT are connected 
together. This completes the decoding of port 
254 (hex FE). To add the necessary OUT signal, 
run a wire from Z22 pin 3 to ZPORT pin 5. Solder 
together pins 8, 9, and 13 of ZPORT; solder 
together pins 6 and 10 of ZPORT. The BASIC 
command OUT 254,X will activate the signal 
found at ZPORT pin 4. 

Also a part of the reverse video modification 
was the piggybacking of a 74LS74 atop Z26. 
Bend all leads parallel to the body of the IC 



except power pins 7 and 14. With the integrated 
circuit oriented in the same direction as Z26, 
mount it there, soldering pins 7 and 14 to the IC 
below. This IC is called ZFLOP. 

Run a wire from the decoded signal at pin 4 of 
ZPORT to pin 3 of ZFLOP. Z59 has a data line 
(bit 0) at its pin 4; run a wire from that pin to pin 
2 of ZFLOP. Now run wires connecting together 
pins 1, 4 and 14 of ZFLOP. With these 
connections made, OUT 254,0 will flip the 
circuit, and out 254,1 will flop it. Note that OUT 
254,0 and OUT 254,2 were the flip-flop 
commands for the reverse video. 

Now the 74LS367 is put in place. As with the 
other ICs, bend all leads except the power pins 
(pins 8 and 16 on this circuit) parallel with the 
body. Place the 74LS367 on Z44, and solder pins 
8 and 16 to it. Call this ZFAST. 

Locate pin 8 of Z56, whose trace is already cut. 
Run and solder a wire from this pin to pin 2 of 
ZFAST. Run a wire from pin 3 of ZFAST to the 
plated-through hole, which was previously 
marked for reference. Take care that this is the 
correct hole before soldering; it is the other end of 
the trace cut from Z56. 

The normal clock will now be reunited with the 
CPU. Run a wire from pin 5 of ZFLOP to pin 1 of 
ZFAST and solder. When OUT 254,1 is 
executed, the normal speed will flip in place. The 
other speed output buffer is wired now. Tie pins 
13 and 3 of ZFAST together. Last, run a wire 
from pin 6 of ZFLOP to the second gated section 
of ZFAST, pin 15. 

The higher speed will now be selected. The 
options are two, and you may try either 150 
percent normal speed or a hot 200 percent 
normal speed. 

150 percent normal speed: Locate Z43, pin 2, 
which is the 5.32 MHz clock normally used in 
the video divider chain. Run a wire from this pin 
2 to Z56 pin 14. That pin is the input of an 
unused divide-by-two segment of Z56. The 
output (2.66 MHz) of this divider is present at 
Z56 pin 12. Run a wire from there to pin 14 of 
ZFAST. 

200 percent normal speed: Locate Z56, pin 11. 
This is the 3.54 MHz clock not used in the TRS- 
80. Run a wire from this pin 14 of ZFAST. For 
this super-fast mod, the memory select circuits 
must also be dealt with. Locate Z69, and cut the 
trace running from pin 5 to pin 12. Connect pin 
12 to pin 13. This speeds the memory-select 
process (from MREQ and RD) just a tad, but 
enough to cope with the 200 percent 
modification. 
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Figure 4-11. High-speed circuit diagram. 
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The high speed modifications are now 
complete. Reassemble the TRS-80 and run a test 
by trying OUT 254,0 and OUT 254,1, which will 
flip and flop the speeds. The following short 
BASIC program will give a good demonstration 
of the speed differences: 



10 FOR B = TO 1 

£0 CLS 

30 OUT 254, B 

40 FOR X = 1 TO 50 

50 PRINT X; 

60 NEXT : NEXT 

70 GOTO 10 



Listing 4-4. High-speed demo/test program. 

In addition to the modifications themselves, it 
is often useful to know which speed is active. 
There are ways of telling after working with the 
higher speeds: the very slight herringbone in the 
video monitor (turn contrast high to see it) 
changes pattern, programs work faster, etc. 
However, a bipolar LED is ideal for this. 

To pin 1 of ZFAST, attach one end of a bipolar 
LED. Attach the other pin to a 470-ohm 
resistor, and run this resistor to pin 15 of 
ZFAST. The light will show green for one speed 
and red for the other; by reversing the center pin 
of the LED, the color pattern selected can be 
reversed. I use red for the normal speed, and 
green for the higher speed. 




Figure 4-12. LED hig-speed indicator circuit diagram. 



Level I and Level II Together 

Little defense of Level I BASIC has been 
made, but from my point of view, it's a delightful, 
compact little BASIC. My own familiarity with it 
is relatively recent, becausgj ordered my TRS-80 
with Level II installed. Aside from the 
maddening lack of key rollover, Level I seems an 
ideal teaching language, especially for 
youngsters. Together with the excellent Level I 
manual created by David Lien, it is a fine 
introduction to the language, and to computers 
themselves. 

Enough for the defense. The problem with 
Level I is that it is not Level II, and the bulk of we 
TRS users have Level II BASIC installed. Level 

I can nonetheless be co-resident, and there are 
three ways to do it: install the Level I ROM with 
a switch (this is the method presented here); use 
a disk system with the Level I-in-Level II 
program (offered by Apparat and others); or 
relocate and rewrite Level I a bit and burn it into 
an EPROM placed in high memory. 

Level I ROMs are getting harder to obtain 
because of the Model Fs discontinuance, but 
cooperative repair centers or franchise Radio 
Shacks ('Associate Stores', Tandy calls them) 
can often provide the ROM for a few dollars. 
Although I am not one to encourage software 
copying, I do feel that as a TRS-80 purchaser, 
you paid for your Level I ROM if you bought the 
unit with one. If it was not returned when Level 

II was installed, then Radio Shack owes you one. 
Try to get it. 

The other way is to order the ROM as a 
replacement part; Radio Shack's latest 
replacement number is MX4126, and they 
charge $71.25 (!) for it. Finally, you can borrow 
one from someone who has it and copy it into a 
2732 EPROM, but that's still about a $40 
investment. 
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Let's assume you're able to obtain a Level I 
ROM. The ones you want are marked National, 
and are identified with parts numbers 
M2316E/MMS258ET R/N and S/N, or 
Motorola, marked 7807 and 7804 or 7831- 
BASIC1-ROM A and 7832-BASIC1-ROM B. 
Ideal is the single-chip ROM from Motorola or 
Rockwell, marked 7809 and 7845, respectively 
(phew!). Photo 4-(?) shows the two-chip 
(7831/32) set and the Rockwell (7845), mounted 
on an aluminum-foil-covered vegetable tray. 

You do not want the chips marked Intel; these 
are 2716 EPROMs, and the wiring is complex. 
About the only thing they are good for is scraping 
off the label and erasing under ultraviolet light. 
Then you have two spanking new $12 EPROMs. 

Check next to see if you have the two- or 
three-chip Level II ROM set. If you have the 
three-chip set, there will be a connector cable 
running to a separate board taped to the main 
circuit card. If not, both ROM sockets will be 
filled, and installing Level I will be more difficult. 
Last of all, make sure your circuit board is a 'D' 
board, 'G' board or later. 'A' boards won't do. 
(The number is part of the lettering silkscreened 
on the board, such as 1700069D or 1700069G). 

First will be instructions for installing the 
ROM in the TRS-80's with outboard Level II 
ROMs. Mount a double-pole, double-throw 
switch conveniently, but discreetly enough that 
you won't be knocking it into Level I in the 
middle of a four-hour data sort. 
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Level II ROMs: 3-chip set on individual board at the end of a 
cable which is plugged into the main CPU card. 



Open up the TRS-80, and note where the Level 
II ROM cable is plugged. Four (or six) other 
wires run from this Level II board to the rest of 
the circuit card. Find these locations: 

1. The green wire on the Level II board, 
connected near the underside of dip shunt X3. 

2. ROM socket Z33 or Z34 (whichever is 
empty), pins 18 and 20. 

Cut the traces leading from pins 18 and 20 of 
the unused ROM socket. Add a short length of 
wire between pin 20 and the far end of the trace 
that used to lead from pin 18. Solder a long white 
wire to pin 18. Remove the far end of the Level II 
board's green wire from its connection point near 
shunt X3, and solder a red wire there. Solder a 
blue wire to the 5-volt supply found at Z57, pin 
14. Using Figure 4-13, run the white, green, red 
and blue wires to the double-pole, double-throw 
switch. 

Add two 1000-ohm resistors to the circuit to 
hold the ROM chips inactive when they are not in 
use. Without them, inadverent selection might 
take place, and the running program (in either 
language) might crash. 

If you've got the single-chip Level I ROM, 
you're all set to go. If not, the fun begins here. 
Locate the notch on each Level I ROM chip, and 
line up the two chips with each other, precisely 
pin for pin. Now piggyback one atop the other 
and solder all 24 pins so that the result is a 
single, hulking, integrated circuit. Solder 
carefully, keeping the bottom IC anchored in 
conductive foil. The foil will act as a static 
remover and heat sink, both essential in this 
mod. 

Blobs of solder can be removed with some sort 
of solder-wick or a solder-removing vacuum tool. 
This entire chip is then inserted in the empty 
socket, and the unit is ready for testing. Level II 
gives you the expected MEMORY SIZE?, while 
Level I only reports 'READY'. 

If you have the two-chip Level II ROM set, 
there's a bit more work to do. One ROM must 
be removed and piggybacked on the other, 
except for pin 20. Bend pin 20 out straight on 
ROM A (Z33), and piggyback it on ROM B 
(Z34). Run a wire from ROM A pin 20 to Z74 pin 
9. Bend pin 20 out straight on ROM B (Z34), 
and run a wire from this pin to Z74 pin 12. Now 
insert your Level I ROMs in the socket for Z33. 
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TO FORMER LEVEL II 
BGARO CONNECTION 
HEAR Z3 




Figure 4-13. Level I and II switch wiring (3-chip set). 



TO CHIP SELECT (HOH'l 



TO LEVEL I STACKED 
SET PIN 1B 




Since these languages use memory and 
pointers in such a different manner (Level I is not 
by Microsoft, as I understand it), they cannot be 
switched from one to the other directly. You 
must power up to the language you want. 

This can present a problem. If you have 
installed various speed and video modifications, 
you may get the mode you don't want. Level I, 
lacking OUT statements, can't recover from this. 
To avoid it, solder a wire to Z53, pin 12, and 
attach it to one end of a pushbutton; to the other 
end of the button, solder a wire to ground (Z53 
pin 7 is fine for that). This is the system reset 
(SYSRES) signal, a true restart to 0000. 

To use it, power up to Level II, get in the 
video/speed mode you wish using OUT 
statements, switch to Level I (the screen will 
likely display a mess of @9@9@9's), and press 
the SYSRES button. A READY should appear. 
Now dig back in the Level I manual to determine 
if the amount of memory reads correctly. 



Figure 4-14. Level I and II switch wiring (2-chip set). 



Two-chip Level I ROM set can be added by piggybacking them 
and soldering them together. Together with the snaking Level II 
cable, they form a surrealistic electronic landscape. 



114 



On Relocatable Code 



On Relocatable Code 

A great noise is often made by programmers 
and users of the TRS-80. The clamor is for an 
elusive programming quality which allows code 
to be placed anywhere in memory and to function 
from that place. The cry is for relocatable code, 
but it is often called for without understanding 
either the process or the sacrifices it requires. In 
this section I will take a look at the various levels 
of relocatability, and the ways it can be applied in 
low-level languages. 

The most 'relocatable' code TRS-80 users see 
is BASIC itself. No matter what configuration 
changes the system undergoes, whether they be 
the use of low-memory utilities, DOS, etc., a 
normal BASIC program will load and run. A 
BASIC program's portability depends on the 
premise that it is interpreted, containing 
statements that are equally meaningful 
irrespective of the program's position in memory. 
Occasionally that position gains importance, "as 
when numerical variables, strings or arrays are 
referenced within program lines, but normally 
those positions do not become significant until 
the program is in operation. 

Unless the BASIC program is truly a hybrid 
(having other, lower-level languages artificially 
embedded in the code), it is eminently portable. 
All references are resolved by its interpreter, and 
relocatability of BASIC is assumed in the very 
nature of it and similar high-level, interpreted 
languages. In fact, that is the nature of a real 
'language' as we know it as opposed to the 
mysteries of 'code'. 

The distinction between language and code is 
not an accepted one, and the differences will be 
characterized only for descriptive clarity within 
the context of this article. By 'language', I intend 
BASIC, FORTRAN, Pascal, and others, as well 
as assembly language. By 'code', I suggest 
machine code as written in binary or 
hexadecimal for direct insertion in memory. The 
assembly language/machine code interface is 
curious and I will address it in terms of the 
conflict between understanding and using a 
language as opposed to a code. 

At the High Level 

The highest levels of languages are the 
so-called 'descriptive' languages, like IBM's 
report-generator, RPG II. A programmer need 
only describe a group - of tasks and the order in 
which they should be performed, and they will be 
magically executed. Full-dress accounting 



reports, billings, and record-keeping can be done 
with a language like RPG II. Relocatability is at 
best the task of a dour 'systems engineer'. 

Likewise, BASIC normally requires no 
thought to its arrangement beyond the proper 
sequence of line numbers. Statements are 
arranged in the programmer's chosen order, and 
the interpreter selects each one for execution in 
that order. Line numbers are the programmer's 
relocatable reference. Languages containing no 
line numbers often use an implicit 'top-down' 
order; that is, once a task is completed, it is never 
returned to. Still, the program is created with an 
arbitrary arrangement selected by the 
programmer and evaluated by an interpreter 
before its execution. 

Languages which use compilers rather than 
interpreters work in much the same manner. 
Whereas an interpreter selects and executes each 
command and operand during the program's run, 
a compiler produces a block of machine-coded 
information from high-level commands and 
operands. The process is completed before 
executing the program, so valuable space and 
running time can be saved. In either case, 
arbitrary, high-level language can be moved 
about, deleted, inserted, or otherwise altered 
with little regard for the program's ultimate 
position within the bowels of the computer. 

In fact, the question of relocatability is implicit 
in the term 'high-level language', and is an 
essential of its high-level quality. 

The reason the question arises at all is because, 
when writing machine-coded utilities, many 
programmers feel that emulating the portability 
of a high-level language is crucial. It becomes 
even more desirable when programming is done 
for a user rather than another programmer, a 
user whose contact with the machine may go 
little further than that of a traditional computer 
'operator'. 

Accomplishing relocation can be an easier task 
on the Model I than on other computers simply 
because of the extensive ROM-based operating 
system. Before examining some ROM uses (and 
its advantages and pitfalls), let's have a look at 
the qualities and constraints of relocatable 
machine code. 

As a user interested in accomplishing a task, I 
might need to select from a group of utilities 
including sort routines, multiple-precision 
transcendental functions, mundane 
key-debounce and upper/lower case drivers, and 
so forth. Ideally, the order in which I select and 
load these routines should be irrelevant to their 
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operation, in much the same way that utilities 
can be 'ordered up' on a mainframe. 

Microcomputer software authors have not 
generally respected this need; in some measure 
that is forgivable because the approach and 
intent of different utilities from a variety of 
vendors demonstrates that relocatability is only 
one of many potential conflicts to be resolved. 

Hunting Through Memory 

Nearly any well-written program is tailored to 
meet certain requirements which may not easily 
co-exist. Among them are: 

Speed of execution. This applies in two 
ways. The first is the speed at which the 
need for the utility is evaluated - an 
example might be a routine scanning a 
keyboard for a unique combination of 
characters. This should be accomplished 
expeditiously, since no real program 'work' 
is being done. The second speed 
consideration is that, once called for, the 
main routine should complete its work 
handily. 

Conservation of memory. In a system of 
unlimited size, speed can be optimized by 
replication of routines rather than use of 
subroutines. In appliance-level 
microcomputers like the TRS, however, 
support utilities cannot be allowed to 
consume memory space needed by the 
operation of the target program. 

Resolution of Conflicts. 

All operating systems make use of areas of 
critical reserved RAM, which are employed 
to tie together the major pieces of hardware 
and blocks of software. These patch points 
(I prefer this term to 'vector', which also 
means a disease-carrying insect) may be 
needed by many other utilities as well as 
the operating system, and must be 
redirected carefully. 

ROMability. The traditional approach 
states that programs must be created so 
that they can be committed to ROM at any 
time. That is, they should neither modify 
themselves nor contain variable data 
within their bounds. This approach can 
certainly be argued against (I shall). 

Three of these four elements - speed, size, and 
memory sharing - are normally considered in 
utility programming, and become critical in 
relocatable programs. 



In addition, factors to be considered 
exclusively for program relocation are: 

The placement of the program in 
memory. This can be a single- or multiple- 
step process. For example, during loading 
from disk or tape, a program may 
temporarily reside in a single block of 
memory, only to separate itself into smaller 
blocks which are shepherded to other 
memory fields. Electric Pencil is one such 
program. 

Absolute jumps within a program. The 
program counter is instructed to take on a 
new value, a value specified as an address. 
Thesejumps are, when taken, faster than 
the relative branches, because the program 
counter need not calculate an offset to its 
current address. 

(indent absorber)Subroutine calls within 
a program. Effective use of memory space 
makes subroutines very attractive, but 
they require that the program counter be 
assigned a specific new value for their 
duration. 

A relocation block. If the program is 
provided to a user in object-code 
(SYSTEM) format, some portion of the 
program must be dedicated to relocating 

itself in another area of memory. 

Assembly Programming 

When programming for programmers, the 
most convenient way to effect relocatable code is 
to use assembly language, and supply that to the 
user. By labeling all jumps and calls, such a 
program becomes 'relocatable', somewhat in the 
sense that a program conceived in a high-level 
language is relocatable. In fact, in its assembly 
phase, machine coding is a high-level language. 





8000 


ORG 


8000 


210Q3C 


8000 


LD 


HL.3C00H 


11003C 


8003 


LD 


DE.3C01H 


Q1FF03 


BOOB 


LD 


BC.3FFH 


3620 


8QD9 


LD 


(HU ,S0H 


EDBQ 


800B 


LOIR 




21E942 


800D 


LD 


HL.42E9H 


7E 


8010 


LD 


A.tHL] 


A7 


8011 


AND 


A 


C29719 


8012 


JP 


NZ.1997H 


C30043 


8D15 


JP 


4300H 




4300 


ORG 


4300H 


CDB843 


4300 


CALL 


438BH 


23 


4303 


INC 


HL 



Listing 4-5. Machine coding in assembly language. 

Above is a section of assembly programming. 
It makes several assumptions, some valid and 
some not. Let's consider that this program has 
cleared the screen (which it would in the TRS-80 
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configuration) after having performed some 
operations on a BASIC program. It checks 
location 42E9, the start of BASIC, for a zero. If it 
does not find a zero, it assumes a syntax error. 
Otherwise, it moves to location 4300, where it 
immediately calls a subroutine at 4388. 

This is perfectly valid code, but here's a look at 
another way of creating it in this high level 
language: 



D4XA FIGURE 1 


3 


SETUP 


EQU 


8000H 






VIDEO 


EQU 


3C00H 






SCREEN 


EQU 


03FFH 






BASIC 


EOU 


42E9H 






PR0GRM 


EQU 


4300H 






SYNERR 


EQU 


1997H 






TESTER 


EQU 


438BH 




8000 




ORG 


S 


21003C 


8000 


SETUP 


L0 


HL.VIDEO 


11013C 


8D03 




LD 


DE.VIDEO+1 


01FFD3 


8006 




LD 


BC, SCREEN 


3630 


8009 




LD 


(HL),20H 


EDBQ 


800B 




LDIR 




21E942 


8000 




LD 


HL, BASIC 


7E 


8010 




LD 


A,[HL! 


A7 


BOH 




AND 


A 


C29719 


8012 




JP 


NZ, SYNERR 


C3D043 


8015 




JP 


PROGRH 




4300 




ORG 


S 


CD8B43 


4300 




CALL 


TESTER 


23 


4303 


PH0GRM 


INC 


HL 



Listing 4-6. Machine coding in assembly language. 

This assembly program, using its high-level, 
interpretive capabilities, can be easily relocated 
by a programmer changing a few equates. But it 
is not relocatable because it does not meet the 
criteria outlined above - i.e., it contains a specific 
origin (or rather, two), absolute jumps, calls to 
subroutine, and has no visible relocation block. 
Fortunately the start of BASIC has been defined 
in the table of equates, for it too can be a variable 
element where low-memory alterations have 
been made. 

As a programmer's utility, this method is 
acceptable. As a public program, it is 
questionable. The solutions, however, are 
neither easy nor obvious. 

Relocation Blocks, Time, and Space 

The first option is to provide a relocation 
block. The amount of coding the programmer 
must perform is increased, but memory use is not 
affected because this relocation block can be 
deleted upon relocation. A relocation block is 
provided with Radio Shack's KBFIX, for 
example, and with other utilities. The sample 
above might have a relocation block which asks 
for a new base address in protected memory, 
protects that memory, adjusts its internal 
addresses, and automatically checks for the 
beginning of BASIC program storage and other 
patch points it may require. 



For very short utilities, the relocation block 
may be longer than the utility itself, because it 
demands a user prompt and input, minimum 
error checking, calculation of base address, and 
adjustment of patch points. Even using ROM 
routines (such as 28A7 to display a message, 1 BB3 
to accept user input, 1E4A for numeric 
conversions), this process is lengthy. 

One of the most painful aspects of this 
relocation is the adjustment of internal 
addresses; absolute jumps, calls, and table 
locations are among the addresses requiring such 
changes. Then what of the questions of speed 
and conservation of memory? Programs that 
move themselves during the course of operation 
must carry the excess baggage of a lengthy 
self-relocation block or use a plethora of relative 
instructions which can cost time during program 
execution. 

Let's address these speed and space questions. 
Table I lists a number of the relative instructions 
in the Z-80 set, along with the bytes, machine 
cycles and time required for their execution. In 
contrast, Table II presents similar absolute Z-80 
instructions, their execution speeds, and the 
percentage of time and space they require as 
opposed to the relative instructions. 







TABLE I 




Z-B0 INSTRUCTION 


BYTES 
3 


T-STATES 


TIME AT 1 .77 MHz 


LD r, (IX+d) 


19 


10.7 US 


LD (IX+d), r 


3 


19 


10.7 US 


LD (IX+d) , n 


4 


19 


10.7 US 


ADD A, (IX+d) 


3 


19 


10.7 US 


INC (IX+d) 


3 


23 


13.0 US 


RLC (IX+d) 


4 


23 


13.0 US 


BIT b.[IX+d) 


4 


20 


11.3 US 


SET b,(IX+d) 


4 


23 


13.0 US 


JR e* 


2 


12 


6.8 US 


DJNZ e 


2 


13 


7.3 US 



When this instruction is conditional, and the 
condition is not met, it uses 7 T-states (3.9 uS). 

Note: 

V = registers A, B, C, D, E, H or L. 
'd' = displacement byte 00 to FF 
'n' = single-byte integer 00 to FF 
'b' = bit position to 7 
'e' = offset byte 00 to FF 







TABLE 


II 








Z-B0 INSTRUCTION 


BYTES 


T-STATES 


TIME AT 


% TIME k. 


SPACE 




1 






1 .77 MHz 


VS. REL. 


INSTR . 


LD r, (HLJ 


7 




3.9 uS 


37% 


33% 


LD (HL), p 


1 


7 




3.9 uS 


37* 


33% 


LD (HL), n 


2 


10 




5.6 uS 


53% 


50% 


ADD A, (HL) 


1 


7 




3.9 US 


37* 


33% 


INC (HLJ 


1 


11 




6.2 uS 


48* 


33% 


RLC (HL) 


2 


15 




8.5 US 


65* 


50% 


BIT b,(HU 


2 


12 




6.8 US 


60% 


50% 


SET b,(HLJ 


2 


15 




8.5 US 


65% 


50% 


JP nn* 


3 


10 




5.6 US 


83% 


150% 


JP NZ.nn 


3 


10 




5.6 uS 


77* 


150% 
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When this instruction is conditional, and the 
condition is not met, it still uses 10 T-states, 3 
more than the relative branch instruction. In 
programs where such a condition is generally not 
met, the JR e instruction will save both time and 
memory. 

Note: 

'nn' = two-byte interger 0000 to FFFF 

Relative instructions in many cases command 
considerably more time than absolute ones. 
How does this reflect on program speed? The 
design engineers for the 6809 chip reported in 
BYTE a survey of 6800 instruction class usage 
based on static analysis (i.e., with the program 
not running) of 25,000 lines of source code. 
Because of the considerable differences in chip 
architecture between the Z-80 and the 6800, 
especially in regard to the Z-80's multitude of 
registers, this information (see Table EI) is not 
directly applicable. Yet it is instructive, 
particularly in the percentage of subroutine calls 
and branches, instructions similar in the two 
microprocessors. 



TABLE III 




Use of 6800 Instruction Types 




Loads (movement from register to register, end 




from memory to a register) 


23,4% 


Stores [movement from a register to memory} 


15.3% 


Calls and returns (absolute addressing] 


13. Q% 


Conditional branches [relative) 


11.0% 


Unconditional branches (relative) and jumps 




Eabso lute] 


6.5% 


Others 


30.8% 



(Adapted from BYTE, 4:1, January 1879, p. 26) 

A remarkable 30 percent of program space is 
dedicated to motion of the program counter. 
This might suggest that a program using absolute 
instructions would be 15 percent faster overall 
than one using relative branches and calls. Since 
relative calls and returns are complex, however 
(see below), the time savings might be even 
greater. Absolute jumps use more space than 
relative ones, so space savings, though 
significant, would not be as impressive. 

What are the practical implications of this 
speed differential? A 1,000-byte subroutine 
(long by microprocessor standards) with no 
internal loops might execute in four 
milliseconds, as opposed to five milliseconds for 
such a routine written exclusively with relative 
functions. On the average, it might be 200 bytes 
longer. This means 200 iterations per second as 
opposed to 250. For a complex mathematical 
function which iterates through a routine many 
times, it could mean the difference between a 
four-hour and a five-hour run. For a patch to a 



keyboard scan, it could mean adding only a few 
seconds to an hour's program time. And for 
routines involved in occasional string handling, 
printing, low-speed input/output, error 
reporting, or a host of other applications, the loss 
of time is insignificant. 

The application itself is the answer to the 
viability of relative coding. In time-sensitive 
applications (music-generation routines, for 
example), and where every byte of code is 
crucial, relative instructions can interfere with a 
program's effectiveness. In the bulk of TRS-80 
applications, which are seldom so time- 
conscious, relocatable coding through use of 
relative instructions can be very successful. 



Creating Relocatable Code 

The Relative Branch. The first coding choice 
is the two-byte instruction for changing the 
program counter. No matter where the program 
counter is currently pointing, it can be shifted by 
specifying a relative branch. When the high bit 
of the specified offset is zero, the program 
counter is moved ahead (for example, 18 37 adds 
37 to the program counter). When the high bit of 
the offset is one, the program counter is moved 
back, in effect subtracting 80 before adding the 
offset: 



5236 
+ 0D 



5236 
15236+0) 



5236 
+ BO 



51 B6 
(5236-100+80) 



5236 
+ 7F 



52B5 
(5236+7F) 



5236 
+ FF 



5235 
( 5236-1 00+FF) 



Especially gratifying is the notion that the 
page of the address (the high byte) is 
incremented or decremented automatically by 
this instruction: 



PC = 52C5 




(page 


52) 


Execute 1B 37 








PG = 52C7+37 = 


52FE 


(page 


52) 


Execute 1B 37 








PC = 52FE+37 = 


5335 


(page 


53) 


Execute 18 A7 








PC = 5335+CA = 


52FF 


(page 


52) 



The branching can be done unconditionally, or 
on the basis of the zero or carry flags ( JR, JR Z, 
JR NZ, JR C, JR NC). This does not provide the 
options available when using the absolute jump 
(which can act on the status of the parity and sign 
flags), and thus presents additional coding 
demands. 

A special relative branch instruction, DJNZ e, 
automatically decrements the B register, and 
performs a branch to the indicated offset 
whenever B is not decremented to zero. 
Although this instruction can have many uses, its 
two-byte brevity makes it most attractive when 
executing loops. 
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The problem of branches outside the range of 
the +7F/-80 byte offset can be solved by 
inserting 'stepping stones' in the main program 
flow. At the end of any logical program section, 
two unconditional branches may be inserted: the 
first branch serves to skip past the second branch 
to prevent disturbing the program flow in that 
area. The second serves as a stepping stone for 
some branch which is too far (more than 127 
bytes) from its eventual destination. The 
program can be ordered judiciously so as to avoid 
overusing such memory-gobbling stepping 
stones. 

Indexed Addressing. One of the best features 
of the 6500 and 6800-series CPUs is their ability 
to address and manipulate memory without 
continually reloading a register or using an 
absolute address in an instruction's operand. In 
fact, using these processors would be incredibly 
cumbersome without this mode since they 
contain merely two storage registers (X and Y) as 
opposed to the Z-80's sixteen (B, C, D, E, H, L, B', 
C\ D\ E\ H\ L\ R, I, IX, IY). 

The value of the indexing features was 
recognized by the Z-80's designers, who added 
them to the 8080's primitive instruction set. As 
with relative branch instructions, a single-byte 
offset may be added to the value specified by 
registers IX or IY in order to produce the address 
of the desired memory location: 

IX = BAA1 IX = 6AA1 IX = 6AA1 
+ 01 + 7F + A1 

resulting 

address: 6AA2 6B20 6A42 

The address of the index registers themselves 
does not change; the resultant value is stored in 
temporary internal Z-80 registers while an 
instruction is being executed. For example, when 
IX = 6AA1 and the instruction - 

INC (IX + AD 

- is specified, the CPU temporarily creates the 
resulting address 6A42 and increments its 
contents. The value 6A42 itself is then discarded. 

When a desired value is outside the range of an 
indexed register, the instruction ADD IX,pp 
comes to the rescue. The designation 'pp' is for 
any of registers BC, DE, IX or SP, which can be 
assigned specific values representing a full 16-bit 
offset, rather than the 8-bit offset of the indexing 
itself. For example: 

IX = 57EB 
DE = 41 CC 
Execute ADD IX, DE 
IX = gaB7 
DE = 41 CC 



Since it is an offset rather than a specific 
address, and since it remains unchanged after the 
execution of ADD IX,pp, it becomes a perfect 
candidate for use in relocatable code. 

Instructions using the index registers can be 
particularly valuable when lookup tables must be 
accessed again and again. With these commands, 
any registers used as pointers may remain 
unaltered; they need not be redefined each time 
the lookup routine is used. An excellent 
application of the index registers for 
five-character string comparisons is found in 
William Barden's Z-80 Microcomputer 
Handbook. 

Relative Subroutines. No, there aren't any 
secret relative call-and-return instructions that 
Zilog never told us about. Rather, there is a way 
to create the effect of a relocatable call by using 
an index register in combination with relative 
branches. 



This method was detailed in my article, 
'Relative Subroutines for the Z-80', BYTE, 4:12, 
December 1979. It is a bit cumbersome at first, 
and makes it impossible to produce 'ROMable' 
code. In summary, here is how it works (see also 
Table IV): 

1. An index register is set to some point in 
the program. This becomes a reference 
point. 

2. The call is prepared by determining the 
offset from the end of the subroutine back to 
the main program flow. 

3. During program execution, the offset is 
assigned, (using the indexed instruction LD 
(IX+d), n) as the operand of a relative 
branch placed at the end of the subroutine. 

4. A relative branch is executed to the 
beginning of the subroutine. 

5. When the subroutine reaches the end of 
its execution, it moves back to the program 
in progress. 
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7000 


Ralativ 
DD218070 


TABLE IV 
e Subroutine Flow 

LD IX, 7080 ;IN PROGRAM AREA 






7040 
7044 
7046 


DD360BBF 
1B20 


LD SIX+BJ.BF : RETURN OFFSET 
JR S+22 iJUHP TO SUBR. 


7047 
7066 






7067 







1SBD JR S-41 i "RETURN" INSTR. 
< NOTE THAT "BD" IN OPERAND ABOVE WAS PUT 
IN PLACE BY CALLING PROGRAM AT 7040. > 



This method requires careful program 
preparation in that the beginning and end of each 
subroutine must be within the range of the 
calling program, and the offset to IX or IY must 
be within the range of the end of the subroutine. 
If the offset is outside the range of these registers, 
a 16-bit offset can be created as described above 
under indexed addressing. 

There is another option to create relative 
subroutines using the Z-80, but it is not 
time-effective. This involves a ROM call to 000B. 



Jerry Lindsly of West Chester, Ohio, describes it 
this way: 

When faced with the problem of relocatable 
code when using subroutines . . . you can use a 
very useful routine in ROM. Essentially what it 
does is this: 



POP 

jp 



HL 
(HLJ 



; Get return eddrese to HL 
; Return to calling program 



So after you call 000B the PC is in HL. 
relative call is a little more complicated: 



CALL 


00BH 




LD 


DE,0BH 




ADD 


HL.DE 




PUSH 


HL 




LD 


DE.NNNN 


; Offset from first byte 
past JP (HLJ . 
Use XOR A and SBC HL.DE 
if the call is negative, 


ADD 


HL.DE 




JP 


(HL) 





(Those interested in the various uses of this 
routine may write to Jerry at 8106 Quailwood 
Court, West Chester, Ohio 45069). 

One could use the equivalent to such a ROM 
call in the program itself. This might be 
desirable. Certainly, if programmers had not 
learned it over the past two years, then the recent 
ROM changes (and expansions in the Model III) 
might dissuade overuse of calls to the Level II 
ROM. 
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How the System Expands 

Unlike automobiles, refrigerators, or shovels, 
computers are hardly ever completely self 
contained. Even if their manufacturers pretend 
they are making a complete unit, the machines 
themselves seem to desire bursting forth from 
their shells, commanding us to create a tabletop 
electronic octopus. 

The reasons almost sound metaphysical: it 
needs more memory; it needs communications 
capabilities; it needs mass storage; it needs 
hardcopy ... to achieve these goals, expansion 
capabilities were made available for the TRS-80 
by means of an electronic hodgepodge called an 
Expansion Interface. 

The Radio Shack Expansion 
Interface 

The Radio Shack interface originally consisted 
of eight major sections : 

1. An extension of the keyboard's edge-card 
connector, initially reserved for a screen 
printer, but containing all the signals on the 
keyboard's connector. 

2. Two groups of eight sockets, together 
with address decoding, to read and write two 
16K banks of dynamic memory. 

3. A decoded input/output latch for parallel 
printer control. A 'Centronics compatible' 
electronics scheme is used, with a separate 
edge-card connector dedicated to the printing 
task. 



4. A set of decoded memory addresses and a 
LSI (large scale integration) chip for disk 
drive and input/output control. The disks are 
accessed through an independent edge-card 
connector. 

5. A decoded output latch for dual cassette 
selection and control. One input and two 
output jacks are integral to this circuitry. 

6. A decoded, input/output port for serial 
communications control, with accompanying 
terminal for an RS-232 circuit board. The 
RS-232 board is accessed via a separate edge- 
card connector. 

7. A crystal and divider circuitry to provide 
disk access, real-time clock, and other 
interrupt functions. 

8. Power supply circuitry. 

If it seems like a lot of unrelated material to 
pack into a single box, then you're on the right 
track - the track that, for quite a while, meant 
trouble. The electronic clamor inside this box 
was to create a system-crashing din during the 
first year or so of expansion interface 
manufacturing. 

The problems were manifested by memory 
crashes (return to MEMORY SIZE?, keyboard 
lockup, or, in a disk system, complete reboot and 
so on). There were several culprits, but the 
gangleader was the misconceived design itself. 
Putting all that material on a single board was 
inviting trouble, and the actual execution of the 
circuitry compounded it. The main difficulties 
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were memory refresh/select, noisy and dirty 
connectors, weak buffering lines, microphonics, 
and susceptibility to external interference. 

The memory refresh/select lines were noisy 
and unreliable. The purpose of the refresh lines 
is to read the entire memory in intervals of two 
milliseconds or less. The memory-select lines 
provide the signals to select one of the 65,536 
possible addresses when needed by the CPU. 

In many computers, selecting a memory 
address is a fairly straightforward process. The 
CPU signals a memory request of some kind, 
and provides an address on the address bus. The 
selected memory responds by providing or 
accepting data according to the direction of the 
CPU. On the TRS-80, however, type 4116 
dynamic memories are used. These memories 
do not have enough external pin connections to 
accept a complete memory address. Instead, 
hardware breaks the address into two parts, 
which are transferred sequentially. 

Briefly, this is how it works. The address is 
sent out on the address bus. The CPU also 
provides a 'memory request' (MREQ) signal 
which triggers special circuitry. This special 
circuitry stands between the address lines and 
the dynamic memories. This circuitry produces 
a multiplex signal - MUX - which chooses the 
low seven bits of the address. It then sends those 
bits together with a 'row address strobe' - RAS - 
to the memories and reverses the MUX signal to 
choose the high seven bits of the address. Then 
the special circuitry sends those bits together 
with a 'column address strobe' - CAS - to the 
memories. 

This sequence of operation provides all the 
address information needed by the dynamic 
memories to select an address. The three items 
most crucial for smooth memory action are the 
RAS, CAS and MUX signals, and as such, these 
should be clean, noise-free, lines. Within the 
confines of the keyboard unit, this is the case. 
But once forced to travel through a cable (via 
two solder-coated edge connectors) into the 
expansion interface, the signals pick up some 
measure of noise. Once inside the expansion 
box, the noise is increased by the surrounding 
electronic din (remember that a separate crystal 
is onboard), and the requirement that these 
signals feed many other devices reduces then- 
effectiveness. They become electronically tired, 
and memory access becomes erratic and 
susceptible to external electrical influences. 

Thus, memory selection was impaired and 
memory refresh was not necessarily executed 
successfully in less than two milliseconds. 



The next culprit in the expansion box was the 
lack of 'buffering'. In the Technical Reference 
Handbook, the author points out that among the 
requirements for hardware are that it : 

4. Contains a separate power supply. 

5. Does not contain more than 1 LS TTL 
load on any one output from the Computer. 

Points 4 and 5 are very important, if you want 
to guarantee proper operation of your Computer. 
Radio Shack, not taking its own advice, hangs 
five LS TTL loads on data line 0, and four on 
each additional data line. If an RS-232 board is 
installed, that becomes another load. The 
address lines feed as many as three devices. With 
a screen printer or other device connected to the 
expansion interface this load increases, 
respectively, at least once for each additional 
device attached! 

The third system-crashing factor is an 
unusual one, avoided by good circuit board 
layout, but not always anticipated. This is 
covered by the rather unusual term 
microphonics. In other words, when the 
expansion box circuit board is tapped or 
vibrates, those vibrations are amplified and 
communicated throughout the entire circuitry 
by the power supply, data and address lines. 

The keyboard unit can take a hefty bounce. If 
you're brave, give it a try by dropping it six or 
more inches. Chances are a running program 
won't crash. But rap sharply on the expansion 
box with the program running, and . . . you can 
guess. These strong pulses are not in the high- 
frequency range which the 'bypass' capacitors 
(the small disc capacitors scattered throughout 
the computer) can squelch; rather these are 
heavy, low-frequency surges which can be 
electronically interpreted as signal changes. 
Hence, the crash. 

Finally, the electronics, being spread out in a 
plastic case, are subject to the electrical whims 
of the outside world. Seated directly below the 
video monitor, the expansion box is susceptible 
to any strong noises contributed by the monitor, 
or through the power lines and rebroadcast by 
the monitor's circuitry. Printer heads and 
motors, disk drive motors, and what have you all 
let the expansion box know they are operating. 
So it responds by crashing its sensitive and 
overworked memory circuits. 

Several solutions have been created. The first 
was that bulge between expansion box and 
keyboard unit: the buffered cable. The second 
was the 'twisted pair' modification, another 
bulge between the boxes. The last was a 



122 



Chapter 5 



Solving the Ground Problem 



rethinking of the expansion circuitry and 
redesign of the board. The last was the only one 
that worked. 

The idea behind the buffered cable was sound 
- to strengthen the overworked signal lines by 
having them feed a single integrated circuit 
each, and then have that integrated circuit feed 
the expansion box. Furthermore, 'termination 
resistors' could then be added, which work 
something like this: power supply lines contain 
bypass capacitors to squelch noise, but placing 
capacitors on the signal lines would slow down 
important signals as well. Instead, low-value 
resistors could make the signal lines 'hug' the 
power supply and ground lines, increasing their 
resistance to low-level, transient, electronic 
noises. 

First installation of buffered cables were less 
than successful, partly because the three 
memory-select signals were very fast signals 
delayed too long by a combination of buffering 
and transmutation inside the expansion box. 
Thus, these lines were pulled outside the 40-pin 
cable via a three-pin DIN connector, separately 
terminated. This kept them up to speed, but 
isolated them from the accompanying noise. 

Nevertheless, these modifications were only 
making up for difficulties inherent in the 
expansion box design, and could not improve the 
box's susceptibility to noise all around, or its 
microphonic tendencies. 

The solution was to put the buffers on board 
the expansion interface itself, and redesign the 
board to reduce interference. New memory- 
select lines were created by the RAS line alone to 
eliminate noise in these signals, but the method 
used was to create problems concerning speed 
modifications (which, of course, Radio Shack 
did not authorize and could not consider in its 
redesign - see the way out of this problem later in 
this Chapter). 

These difficulties, though, should be placed in 
perspective. When connectors are well cleaned, 
good memories are used to stock the expansion 
box, and the computer's environment kept 
clean, static-free and vibration-proofed, even 
the first, unbuffered systems work successfully. 
My own system (on which this book is being 
prepared) is a 48K, one-disk system with RS-232 
board, printer, two modems, Exatron Stringy 
Floppy, two cassettes and home-brew interfaces 
- all connected to an unbuffered expansion box 
of early vintage. But it must be cared for. The 
designers were simply not prepared for the TRS- 
80's ultimate home and business environment. 



One increase in reliability is not mentioned in 
the Radio Shack redesign. Electronic parts are 
'derated' according to temperature. That is, as 
temperature increases, their performance 
decreases. Some circuits, like 74LS types, are 
strong and steady right to the limit; others, 
particularly dynamic memories, become flakey 
as the heat builds up. Thus, reliability of the 
expansion box can be improved by removing the 
two power supply transformers from the 
expansion box. 

Solving the Ground Problem 

I call this a ground problem, but it really 
refers to the microphonic tendency of the 
expansion board. The first and easiest solution 
is to remove and cushion the expansion circuit 
board. One principle of vibration-proofing is 
that when different materials are sandwiched 
together, a certain amount of sound and 
vibration energy is reflected back from the 
junction of the different materials. 

Thus, all sources of potential vibration should 
be cushioned. Set a thick cloth (like terrycloth) 
on your computer desk, and a wooden baseplate 
atop that. On it, place a mat made up of several 
thin layers of plastic pad, rubber foam, and 
cloth to a thickness of about 1/4 to 1/2 inch. 
Assure that the keyboard unit and interface seat 
comfortably in them (you might drill shallow 
depressions in the wood for stability), but that 
there is some air space for cooling. Remove all 
the plastic doors which attach to the interface 
and discard them. In their place put rectangles, 
made of alternating layers of cork and 
styrofoam, which snuggle firmly between the 
connectors and the UDner and lower walls of the 
case. See Figure 5-1. 




Figure 5-1. Shockproofing diagram. 

Other sources of vibration are the cables that 
attach to the expansion box. Rather than have 
cables vibrate and swing with a printer, or stretch 
when you readjust the position of a disk drive or 
modem, sandwich each one under a leather (or 
synthetic plastic, if you prefer) bridge, and screw 
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Photo 5-1. Photos on opening the expansion box. 

Screws are removed from bottom; note that like the CPU, a 

warranty-warning label may cover one screw. 



Bottom is lifted off to reveal top of expansion circuit board 
Screws holding circuit board are then removed. 



the ends of this bridge through the cushion pad 
into the wooden base. When jostled, the cables 
should not move between the bridge and the 
expansion box. 



Finally, avoid the possibility of stretching the 
keyboard/expansion box cable. The best way is 
to drill shallow depressions in the wood base, as 
noted earlier. 

These are not specifically electronic hardware 
corrections, because only a thorough redesign of 
the expansion interface can truly cure these 
microphonics problems. 

Expanding to 32K and 48K Memory 

Memory expansion in the interface itself is 
quite simple. Remove power from the interface, 
disconnect cables, and lift out the power supply 
transformers. The latter action is necessary 
because the power supplies will only fall out 
anyway when the bottom comes off. Flip the 
expansion box over, and remove the six black 
Phillips screws. Lift off the bottom cover. 

There are sixteen unfilled sockets on the 
board, reserved for memory expansion (see 
Photo 5-2. The higher-numbered sockets (Z- 
9 to Z- 16 will be used for the first block of 
memory, for a 32K total RAM. The lower- 
numbered sockets expand the system to the 
complete 48K. 

The memories to be used are type 4116, as 
used in the keyboard unit (see Chapter 4). 
There are some differences, though. Oddly, 
some sources claimed that slower memories 
seemed to work better in the older interfaces, 
but fast 250 nS RAMs are the most commonly 
available now. I have not come across an 
expansion box of any vintage that could not take 
fast RAMs like these, including my own, which 
dates to early 1978. 

First, refer to Chapter 3's notes on handling 
static sensitive integrated circuits. Take each 
RAM and orient it with its notch or dot at the 
top facing in the same direction as the notch in 
the sockets (and in the same direction as the rest 
of the integrated circuits on the board). Fit each 
one of the first eight chips carefully in place, 
being sure that the pins slide into the sockets 
and neither buckle underneath the IC nor slip 

outside the socket edge. Press the memory chip 
gently but firmly in place. 

Now, before installing another 16K memory 
block, test this group. Flip the expansion box 
over (the cover need not be installed), reconnect 
cables and power supply, and power up the 
expansion box. While holding (BREAK), power 
up the computer itself, and press (ENTER) in 
response to MEMORY SIZE. Now PRINT 
MEM, and a figure of 31956 will be displayed. If 
all is well, power down, remove cables, and 
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insert the remaining eight memory chips. Again 
restore cables and power, and go through the 
initialization procedure. Memory should now 
read 48340. Replace the cover and cover screws, 
and you're set with an expanded system. 

Problems? If there are any, they will likely fall 




IfRS-232 board is in place, the two screws holding it must also be 
removed. 
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Entire expansion card lifts out easily. 




into these categories: 

1. PRINT MEM returns 15572 or some 
figure much below the expected 32K value. 

2. The system continuously crashes back to 
MEMORY SIZE? or just locks up. This 
happens most often while running any 
program. 

3. The system just locks up with garbage on 
the screen at power-up. 

Well, the last first. Don't forget to hold the 
(BREAK) key down at power-up in a non-disk 
system. The other two are tougher. 

If PRINT MEM returns 15572, you might 
have installed the memory incorrectly. Keep 
booting (press the Reset button while holding 
down (BREAK)), and hitting (ENTER) in 
response to MEMORY SIZE? PRINT MEM, 
checking over and over. If a figure higher than 
15572 is ever returned, you might have expansion 
box problems. 

Try entering a number between 15580 and 
32700 in response to MEMORY SIZE?. If it is 
ever accepted, chances are you've got the 
memory chips installed correctly. Try POKEing 
and PEEKing, like this : 



POKE 25000,100 
POKE 26000,103 



PRINT PEEK12B000) 
PRINT PEEK126000] 



and so on. If the value you POKEd is the same 
as what you PEEK at, the memory is there, but 
it's not acting reliably. Here are a few solutions 
(see also the expansion box general solutions 
above) : 

1. Clean cables, connectors, etc., and shock- 
proof the unit. 

2. Remove the buffered cable if you have one, 
and replace it with a regular one. Before you 
do this, open the expansion box and find pin 
#1 on the edge connector. Cut that trace, 
or remove the wire you see there. This is the 
5- volt power supply to run the buffering box. 
The matching pin on the keyboard unit is a 
ground! 

3. If you have a newer expansion box, make 
the high speed alteration noted above, 
although you shouldn't be having these 
problems with the new box. 

4. You actually might have some flawed 
memory chips, though this is unlikely. 
Switch those in your keyboard unit with those 
in the expansion box, and see if the problem 
goes away (or the keyboard unit doesn't work 
now). Run the memory test (Chapter 3) to 
find out which chip(s) may be bad. 
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P/ioto 5-2. Expansion interface memory sockets. 
32K memory fits into sockets Zl through Z16. Oddly, Tandy 
engineers did not install power supply filter capacitors C54 and 
C55, nor are they included in the schematic drawing. 



5. Make the small change to Z69 in the 
keyboard unit, as described in the 200% 
speed-up modification. 

The options are few when dealing with an 
older expansion box. They will work, but you 
have to provide them with ideal conditions. 
Which points out the solution to the possible 
program crashes noted in problem number 3 
above. Pamper the expansion interface when a 
program is running. Don't have the kids playing 
kick-the-cat near the computer, or the dog 
jumping about and thumping a large tail next to 
you, waiting to be fed. Keep the washers, driers, 
and mixers in the vicinity switched off. 

Speeding Up Newer Expansion Boxes 

Radio Shack's cures for the memory 
refresh/select difficulties in the expansion 
interface created a new problem for those who 
wish to increase the speed of the computer. All 
three select lines (RAS, CAS, and MUX) are not 
used in the revised expansion box; instead only 
RAS is used. 

Technically, the RAS line is sent thrice 
through an inductance network which provides 
three differently delayed doppelgangers of the 
original signal. These are tweaked back into 
digital shape by a buffer circuit, and the three are 



labeled MRAS, MMUX, and MCAS. The ploy 
works. 

Trouble is, these lines don't care about the 
speed of the central processing unit. Fast or 
slow, the false MMUX and MCAS signals trip 
along at a fixed rate after MRAS. The only cure 
is to somehow speed up that rate and buy fast, 
high-quality memory. The speedup is 
accomplished by not delaying the RAS to 
produce MRAS, and creating MMUX and 
MCAS in the old MRAS and MMUX positions, 
respectively. The faster memory (200 nS) is up 
to you. 

To provide the speedup, you'll need to cut 
some traces and run some wires. Remember, this 
adjustment is for newer expansion boxes only - 
the ones that the sales clerk says "don't need the 
buffered cable". Here is the order : 

1. Find Z37 and Z38. 

2. Cut the trace leading from Z38, pin 9. 
Call the end furthest from Z38 'Trace A'. 

3. Cut the trace leading from Z38, pin 8. 
Call the end furthest from Z38 'Trace B'. 

4. Cut the trace leading from Z37, pin 4. 
Call the end furthest from Z37 'Trace C. 

5. Attach Trace A to Z38, pin 11. 

6. Attach Trace B to Z37, pin 4. 

7. Attach Trace C to Z38, pin 9. 

The modification is complete. Close the box 
and power up again; the system should work 
normally (if not better as time goes by). Both 
higher speed modifications presented in Chapter 
4 will work with these changes, so long as your 
memory is the faster, 200 nS type. If the 
memory seems at all unreliable, double-check 
your work. If the work is fine, then your memory 
may not be up to the change. 

LNW, Microtek and Other Expansion 

Interfaces 

The first of the TRS-80 products to be 
attacked, and rightly so, was the flakey 
expansion interface. By the time Radio Shack 
was offering its initial hopeless 'fixes', a trio of 
Californians were redesigning the box for their 
colleagues in a TRS-80 user group. This was to 
become the premier challenger to the expansion 
interface, the LNW System Expansion, priced at 
a mere $70 for the bare board, circuit diagrams, 
parts placement, and a few additions to the 
Tandy system. 

The LNW System Expansion is essentially the 
Radio Shack expansion interface with a new 
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Using Those 4K Leftovers 

Did you insist on keeping the 4K RAMs 
which were removed from the keyboard unit 
when your 16K RAMs were installed by Radio 
Shack? Or did you do the installation yourself? 
If so, you've got 4K of dynamic memory worth 
about $20 off the shelf. But the trouble is you 
can't use them in your expansion box, because 
it's set up for 16K memories only. 

But, if you want to spend a bit of time and 
can't afford an expansion interface, you can 
extend that PRINT MEM to 19668! Almost 



everything is in place already, so all you need is 
an address decoder and multiplexer circuit. 

The circuit presented below can be wire 
wrapped on a small board, and will provide that 
extra 4096 bytes. The cost? About $5 for circuits 
and sockets, another $5 for an edge connector 
(use the Texas Instruments wire wrap type sold 
by Digi-Key, part number C6-20), and some 
time. 

When you begin to fill your expansion 
interface, though, you'll have to give up the 4K 
RAM extension, because the first block of 16K 
memory in the box takes those memory 
addresses. 




Figure 5-3, 4K dynamic RAM add-on circuit 
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Hefty power supply inc/udes fuse and multiple heat sinks, unlike 
TRS model with inaccessible fuse and light heat sinks. 



layout, on-board buffers (which appeared finally 
on Radio Shack's own product in the spring of 
1980), standard RS-232, and noise-reducing 
passive bus termination. This last was of 
particular importance in making the LNW 
board noise-free and consequently crash-free. 

As with the Radio Shack expansion, the LNW 
board has sockets for 32K additional RAM, but 
also suggests that sockets be used for all parts - 
good advice, especially since chips such as the 
open-collector buffers used in the disk line driver 
need occasional replacement. 

This board is also modular in a way that the 
complete, boxed interface from Tandy could not 
be. Only as much as the user needs at one time 
may be installed. Thus, the $25 disk controller 
chip can be left out of the system until (or if) a 
disk drive is added; so also the disk's peripheral 
chips can be omitted. Where interrupts are not 
desired, the entire crystal controlled clock can be 
excluded. Less than $150 gets the user a 
bare-bones 32K memory expansion. 

The trick to the LNW board is dexterity. This 
is not a project for total novices, because it 

involves extensive sold ering and some 
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LNW Expansion compared with TRS-80 monitor. Board is 
Oapproximately the same size as standard TRS expansion interface 
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Communications are built into LNW expansion; TR1602 UART 
provides serial capabilities. Note clear marking of all parts, 
including an industry part number at the UART socket 



knowledge about what the parts look like. There 
is no Heathkit-style check-off list. You get a 
parts layout, schematics, and encouragement. 
But you also get a noise free, reliable expansion 
interface. 

For those who plan to build (or have already 
built) the LNW board, a few changes might be 
in order. If you wish your reset button to work, 
you must not only make a change similar to that 
for the Radio Shack expansion box, but you 
must also change the values of the pull-up and 
pull-down resistors. Change the pull-up 
resistors on the data lines to 470 ohms, and the 
pull down resistors to 680 ohms. This will 
provide the desired 11111111 signal when the 
reset key is hit and the disk buffer-disable 
modification has been made. 

To make the mod, turn to the expansion 
interface reset recovery presented in Chapter 
(?), and follow those same directions, but using 
the integrated circuit on the LNW board marked 
U19. 



Special Section: Two Other 80s 
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Virtually complete LNW board in use. User has added 
programmable baud rate generator (bottom right) in place of 
hard-wired jumpers recommended by LNW Research. 



The PMC-80. 

As production of the TRS-80 Model I was 
winding down at Tandy, the rumored 'Hong 
Kong Copy' made its appearance in the United 
States, under the name PMC-80, and sold by 
Personal Microcomputers, Inc., of Mountain 
View, California. 

I was personally ready to greet the PMC-80 
with much skepticism, expecting a weaker 
TRS-80 with little to commend it and a lot to 
avoid. But, tacky advertising aside, the PMC-80 
is a functional, satisfactorily designed product. 
In fact, because of the experience of the original 
'80 itself, this copy is probably better designed 
than Tandy's product. That's probably an 
indirect compliment to both Fort Worth's 
foresight and Microsoft's Level II BASIC, which 
the PMC-80 contains virtually byte for byte. 

First, the obvious similarities : 

1. Z-80 microprocessor running at 1.77 MHz. 

2. 64 x 16 screen resolution, with 128 x 48 
graphics. 

3. Video monitor output compatible with 
the Radio Shack monitor. 

4. Microsoft Level II BASIC in a 3-chip 
ROM set and standard type 4116 16K 
memory. 
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And then, the differences : 



Photo 5-3. The Z-80 CPU — Used in the PMC-80. 



1. Built-in cassette player with no level 
control necessary, with provision for two via a 
second cassette jack already in place. 

2. Video RAMs are in sockets, all seven are 
installed for lower case use, and an industry- 
standard character generator is used. Lower 
case is not provided, but is available. 

3. An oversized, well-ventilated power supply 
feeds the system. 

4. Channel 3 RF video is provided, along with 
a connector cable and adaptor. 

5. Keyboard has a cassette motor on/off 
control, but is missing clear and right-arrow 
keys. These can be installed by the user on 
some machines. 
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complete PMC-80 system can include CPU unit with cassette, 
printer, expansion box, monitor, and disk drives. Photo courtesy 
of Personal Micro Computers, Inc. 
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6. An odd 32-character mode, selected 
differently (with a switch). Instead of 
alternate letters in video memory, the 'left 
half of video memory is used. Normal 
CHR$(32) is shown instead as normal-size 
letters appearing alternately on the screen. 

7. The keyboard types easily, with no 
evidence of keybounce. 

8. The expansion connector is gold-plated, 
but the inter-board and keyboard connectors 
are just solid wires pushed into receptacles. 
Heavy duty relays are used for the dual- 
cassette I/O. 

9. The gold-plated expansion connector, alas, 
is not a TRS-80 compatible 40-pin type. The 
PMC-to-TRS adaptor is an option. 



Are the TRS-80 and PMC-80 software- 
compatible? From what I can tell after running 
both BASIC programs and machine language 
utilities employing calls to ROM: yes, with 
minor reservations. First of all, the missing clear 
and right arrow keys are a downright pain; users 
of programs such as Scripsit or the Penmod 
version of Electric Pencil are back in the good 
old days of having to add keys to the system to 
get these programs to work. 

Major ROM calls, though, seem to be intact, so 
there's little worry about compatibility there. 
The only programs that seem to get lost are those 
that call inside routines, or that call partial 
routines in ROM. BASIC runs flawlessly, as do 
mixed BASIC/machine programs. 
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Inside the PMC-80. Keyboard, two electronics boards, cassette 
player, and power supply are attached to the baseplate. 
Multiconductor wire jumpers plug in place. 
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Keyboard connector attaches to main board via a removable 
cable, a distinct improvement from the permanent TRS-80 cable. 
Note Z-80 CPU underneath cable. 



Other comments : 

The video display is cleaner, and the letters 
are better formed, prettier, and with no touch 
of blurring, even on the inexpensive TRS-80 
monitor. They are quite similar to the better 
quality characters of the TRS-80 Model m. 
The lowercase option was not installed in the 
unit I used, but since it uses the standard 
character generators and has a clean video 
output circuit, similar well formed letters can 
be expected. 

Cassette input/output is sweet. Problem 
programs loaded easily with this system. 
The playback of the cassette deck is 
digitized with LM324 comparators instead of 
3900 Norton amps, and so the digitization is 
more successful. 

The overdesigned power supply shows every 
sign of providing plenty of surplus current. 
There is no need for power supply 
adjustment in this system, because in place 
of the adjustable 723 regulator used in the 
TRS-80, fixed 7812 and 7805 regulators are 
employed. 
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Hefty power supply provides drive for computer electronics as 
well as a separate supply for the cassette recorder. Fuse is user- 
replaceable, in a standard socket 



The unit, though heavier than the TRS-80, is 
more complete in the sense that it has a built- 
in cassette player and RF video output. For 
traveling, the PMC-80 makes much more 
sense, because a video monitor can be used in 
long sessions at home or office, and an 
ordinary television can be used at other times. 
The case is tacky, especially the fake walnut 
grain plasticoid sides, but then the down-to- 
business futura TRS-80 was no great 
aesthetic shakes, either. The keyboard is 
placed at a comfortable angle, and the added 
weight and size gives the unit a more 
responsive typing feel. 



The LNW-80 Kit. 

This is a welcome newcomer, providing the 
advantages of the Model I with LNW's well 
respected circuit board. As with their system 
expansion, this LNW board is sold naked. The 
user contributes the parts as required. 
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Under the keyboard is the complete electronics control 
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CPL7 contra/ cord contains 3-chip Level II ROMs, 1 6K dynamic 
memory, and power supply. Circuit board design isn't pretty, but 
is very reliable. 
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Video display card includes 7-bit video memory (unlike original 
TRS-80 6-bit memory), industry- standard CGR-001 character 
generator, RF modulator, and sockets for video memory chips. 



CPU Interruptus 

The interrupt is a programmer's mystery tool. 
On large machines the interrupt controls are so 
sacred that they are available only to the system 
engineers. Without a password, assembler 
commands directed toward interrupts are 
generally ignored. 

TRS-80 users might have in mind some 
dreams of the Z-80's interrupt power. They've 
heard of it. Allusions have been made to it. Yet 
because it operates outside familiar 
programming bounds, it is even now a mystery. 

Furthermore, this may be one of those cases 
where the Tandy engineers seriously erred in the 
concept, (rather than in the design, which 
problems we know all too well). The inclusion of 
additional interrupt power could have been done 
for pennies. 

Whatsis? 

The activities of a computer program can be 
viewed in relative rather than real time. In other 
words, a computer performs its tasks in the order 
that the programmer has chosen, with a timing 
that is inherent to the oscillations of the 
computer's master clock. Change the spacing of 
those oscillations, and the absolute time - the 
time with respect to 'real' time - changes, yet the 
relative time within the computer program is still 
the same. 

Unfortunately for timekeeping purposes, 
changing either the clock of the computer, or 
changing the way in which the computer handles 
its tasks, may actually cause a shift in the real 
time reported to the user. An interrupt, then, is 
electronic shoulder tapping, the ability of a 
device external to the microprocessor and its 
respective memory to demand the CPU's 
attention for imperative tasks. For example, an 
external pulsing clock says to the CPU, 'Okay, I 
don't care what you're doing, stop it now and 
take care of updating of the real-time clock.' 

Such is the simplest use of an interrupt. And, 
for a change, the computer jargon term is true to 
its actual purpose. It interrupts the operation of 
the central processing unit, demanding 
attention. 

An interrupt is akin to a ringing telephone. As 
long as you are within earshot, the ringing of the 
telephone interrupts your activity. Whether you 
choose to respond consciously to it is irrelevant to 
the actual interruption. If you can hear, and if 
you are within hearing range of the bell, it does 
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indeed influence the activities of your nervous 
system. 

How you respond to that ringing telephone - 
whether you ignore it, whether you go to it and 
answer it, or whether you merely swear at it - is 
what might be called, in computer terms, 
'servicing the interrupt'. 

The Z-80 microprocessor contains a wide range 
of ways in which an interrupt may be 
acknowledged, received, or serviced. You 
respond to a knock, doorbell, telephone, child's 
cry, or gunshot with various levels of urgency. If 
more than one were to occur about the same time, 
you would be forced to mask out the one of lower 
priority and give your attention to the more 
pressing interruption. 

Before describing the ways the Z-80 
microprocessor might respond to an interrupt, it 
should be noted that an interrupt is uniquely 
different from the computer's usual 
input/output schemes, just as the ringing 
telephone or gunshot are considerably different 
from checking the color of a traffic signal as you 
approach it; inspecting the mailbox as you arrive 
home; or scratching the cat. 

In these analogies, your ears most often serve 
as your human interrupt line. As long as they are 
'in the circuit', they will interrupt you. You can 
close your eyes to the traffic signal, ignore the 
presence of the mailbox by averting your glance, 
or cold-shoulder the cat (at your own risk), but 
(lacking earflaps), sound will give you an 
appropriate kick in the eardrums. 

Back to the Z-80's interrupt schemes. During a 
movie, were someone to yell "Fire!", chances are 
that everyone - barring suicides and 
existentialists - would respond to that 
interruption with their personal interrupt 
service routine. Most likely that routine would be 
to leave the theater quickly. 

An equivalent reaction by the Z-80 is produced 
by a signal applied to its 'non-maskable 
interrupt' (NMI). This interrupt is always 
acknowledged. The CPU cannot ignore it. On the 
TRS-80, it is this interrupt which is activated 
when the Reset button is pressed. 

The NMI is hard-wired into the system in such 
a way that we have no control over it, so that if 
these sentences were a program . . . 

READY 
>_ 

. . . and not only that: the execution of a HALT 
instruction produces a 'Halt Acknowledge' 
output signal which the Tandy Engineers have 



OR-gated with the NMI to ... 

READY 
>_ 

. . . yup, you guessed it. 

Contrarily, the Z-80 has a maskable interrupt 
(INT). It is an interrupt line which, when 
activated, may either be ignored or 
acknowledged by the processor if the 
programmer has so specified. 

Because their activities are not fixed, these 
maskable interrupts are the ones of interest to us. 
Although, as I've said, the Z-80 was designed with 
a wide range of interrupts, that wide range is not 
accessible to TRS-80 users because the Tandy 
engineers did not design the TRS-80 in a way 
that could make those interrupts available. 

Nevertheless, here is a look at the Z-80 
interrupt modes. 

Mode 0. This mode allows the interrupting 
device to place a machine language 
instruction directly on the data bus. The CPU 
will then execute that command rather than 
the next instruction in the normal program 
flow. Designers of the Z-80 suggest that a 
restart (RST) instruction be used. 

Restarts have been covered in The Alternate 
Source and other publications, but briefly, they 
are single byte subroutine calls especially 
designed for this kind of interrupt operation. 
Normally, subroutines require specification of a 
CALL instruction (CD) and two absolute 
address bytes. The RST instruction is a single 
byte command causing the CPU to stash the 
program counter on the stack and move to one of 
eight locations in low memory. 

Mode 1. Upon interrupt, this mode forces the 
CPU to preserve the program counter and 
then move directly to location 38. 

(line to absorb indent) 
Mode 2. This is considered the most powerful 
interrupt response mode of the Z-80 because 
"the programmer maintains a table of 16 bit 
starting addresses for every interrupt service 
routine . . . When an interrupt is accepted, a 
16 bit pointer (is) formed to obtain the desired 
interrupt service routine address from the 
table. The upper 8 bits of this pointer (are) 
formed from the contents of the I register. The 
I register must have been previously loaded 
with the desired value by the programmer. 
The lower eight bits of the pointer must be 
supplied by the interrupting device...." (from 
Z-80 Technical Manual). 
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Before you permit excitement (or even a 
raised eyebrow) about the last interrupt mode, it 
should be pointed out that neither Mode nor 
Mode 2 may be used on the TRS-80, for this 
hardware reason: in order to place any 
instruction or address on the data bus, it must 
be possible to configure the data bus as an input. 
Within the internal circuitry of the TRS-80 
itself, the data bus is fully bidirectional. This is 
normal, because the data bus is in an input-to- 
CPU state whenever memory is being read or 
input intructions are being executed, and in an 
output-from-CPU state whenever information is 
being stored in memory or output instructions 
are taking place. 

Unfortunately, only the data output is 
brought to the edge card of the TRS-80. There is 
no buffer wired to the edge card which is pointed 
inward to the CPU, activated when the IORQ 
signal is sent from the CPU during interrupt! 
Therefore it is impossible to place either an 
instruction or an address byte on the data bus 
from outside the computer. 

(Of all the possible under-utilization of the Z- 
80's power in the TRS-80, this is to me the most 
discouraging. You can cure something like the 
stingy lack of an extra video bit for lower case, 
but adding a second set of buffers requires a true 
hardware hacker. You might as well build a new 
computer. Aveatquevale, Model I.) 

Thus, the balance of this section will be 
concerned exclusively with interrupt Mode 1 (set 
by executing the command IM1). As noted, the 
execution of this instruction forces the CPU to 
address 38. 

Address 38 has also been usurped by the TRS- 
80 designers by placing it in ROM (read only 
memory). Because the first act of the instruction 
at 38 (which incidentally is the last of the RST 
instructions) is to jump into RAM at 4012, it can 
nevertheless be accessed easily. 

With a Level II CPU unit alone, the edge-card 
connector is brought out so the interrupt line is 
present. However, if you are an expansion 
interface owner or disc user, then you should 
know that the interrupt itself is dominated by 
the expansion interface unit's clock, which 
places a constant 25-millisecond pulse on the 
interrupt line. Therefore, not only are interrupt 
modes and 2 made unavailable by the TRS-80 
design, but (unless you are willing to cut a trace) 
the presence of the expansion interface limits 
even the use of Mode 1. 

Despite all these limitations (whew!), the 25 
mS interrupt does allow options beyond just the 



real-time clock. 

Which brings us to the reason the Z-80 has so 
many interrupt modes. The most powerful kind 
of interrupt places an instruction or address on 
the bus, directly influencing CPU activities every 
time it occurs, but only when it is needed. If the 
hardware is well designed, this means every 
interruption is essential, and is handled 
expeditiously. 

On the other hand, 'polling' interrupts for 
service requests is wasteful. That is, when there 
is a single interrupt mode which all devices must 
use, then the CPU is forced to ask each one, 'Did 
you interrupt me? No? Well, did you interrupt 
me? No? Well then, did you interrupt me? No? 
Okay, then . . .', until it finds the culprit. It not 
only services it, but also checks the remainder of 
the devices in case other interrupts occurred 
simultaneously with the first, or during the 
interrupt service routine. 

We are therefore limited not only to a single 
interrupt mode, but also to a required polling 
technique, because this 40-times-per-second 
pulse is coming through without cease. No real 
'device' is asking for service, but the effete 
request is present nonetheless. Yet we can still 
use it. Here's how: when the interrupt comes 
through, the CPU sends a signal to the relatively 
few devices in our I/O scheme, and asks them, 
'do you have any information?' If there's no 
information, the CPU will quickly beat a path 
back to normal program flow. If there is 
information, the CPU will service the interrupt. 

Whysis? 

You may wonder what type of situation — 
within the context of the humble TRS-80 itself 
— might require this interrupt, other than the 
familiar real-time clock. Let's take an example 
of flawed human interaction in TRS-80 
programming: the Electric Pencil. 

As any reasonably good typist knows, this 
'text editing' program is infuriatingly slow at the 
end of lines, particularly at the bottom of the 
page. Not only must it move the word in progress 
to the next line, but also scroll all 1,024 
characters up the screen. If you are nimble- 
fingered, you can lose characters during this 
process. 

The interrupt system might be used in order to 
build a buffer of keys pressed. A good typist's 
fastest keystrokes ('the', 'is', etc.) can be less than 
50 mS apart, or 20 characters per second. As the 
interrupt comes through from the expansion box 
40 times each second, location 387F can be 
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examined by the CPU. If any key other than 
'shift' is pressed, its presence can be sensed by 
looking at this location. If its presence is sensed, 
the key-scan routine can be initiated, and the key 
information and any successive keystrokes are 
stored until the line break and/or scrolling is 
completed. 

In this way the keyboard may be 'scanned' 
quickly, not only during entry of text, but also 
during I/O, such as to tape. A keystroke buffer 
may be built during this process (since the 
keyscan need only be initiated if a key is pressed) 
between output bytes. The same is true of 
printing; the text can continue to be output to the 
printer while this activity is going on. 

In fact, if a key were pressed during an I/O 
routine, it could be accepted into a buffer, and 
subsequently displayed when the next interrupt 
occurs. In effect, you would be time-sharing your 
TRS-80. 

Light Bulbs 

Aha! Time-sharing your TRS-80! (Light bulbs 
flicker on in millions of brain rooms). Although a 
25-mS pulse does not allow totally transparent 
time-sharing, it allows enough of it for your 
TRS-80 to be able to service several user 
requests at a time, in different ways. 

But first, here's a short routine to prove that 
the interrupt is really there. You can assemble 
this, or just POKE it into memory. 



7F0D F3 




DI 




;Interrupt6 off 


7F01 3E C3 




LD 


A.QC3H 


;Gat JP command 


7F03 32 12 


40 


LD 


[4012H),A 


;Reptace RET cmd 


7FQB 21 14 


7F 


LD 


HL.7F14H 


;Start service 


7F09 22 13 


40 


LD 


(4013H),HL 


;Place after JP 


7F0C 21 19 


1A 


LD 


HL.1A19H 


;Command Level 


7F0F E5 




PUSH 


HL 


;Ready to returr 


7F10 ED 56 




IM 


A 


;Set to Mode 1 


7F12 FB 




EI 




;Interrupts on 


7F13 C9 




RET 




;Raturn to 1A19 



The segment above is merely a setup routine, 
executed once. It disables interrupts during 
setup, places C3 (a jump instruction) in place of 
C9 (return) currently found at 4012, the 
interrupt patch point in RAM. It then places the 
destination address (7F14) as the jump's 
operand. It pushes the return to BASIC or DOS 
onto the stack, sets interrupt Mode 1, enables 
interrupts, and returns (effectively jumping to 
1A19). 

Note that after an EI (Enable Interrupts) 
instruction, acknowledgment of any interrupts is 
actually delayed until after the completion of the 
instruction following the interrupt enable. 
Here's the interrupt service routine itself : 



7F14 
7F1S 
7F16 
7F17 
7F1B 
7F19 
7F1C 
7F1F 
7F22 
7F25 
7F2B 
7F2A 
7F2B 
7F2C 
7F2D 
7F2E 
7F2F 



F3 

F5 

E5 

D5 

C5 

3A EC 37 

3A E0 37 

21 11 01 

11 25 3C 

01 1A 00 

ED B0 

C1 

D1 

E1 

F1 

FB 

C9 



DI 

PUSH 

PUSH 

PUSH 

PUSH 

LD 

LD 

LD 

LD 

LD 

LDIR 

POP 

POP 

POP 

POP 

EI 

RET 



AF 

HL 

DE 

BC 

A,(37ECH) 

A, I37E0H) 

HL.0111H 

DE.3C25H 

BC.001AH 

BC 
DE 
HL 
AF 



Interrupts off 
;AU of these 
registers 
Hi IL be used 
to do this 
Reed disc chip 
Reset clock F/F 
Messege stert 
Display specs 
Messege length 
Displey it 
Put all these 
registers 
back in 
piece 
Interrupts on 
iReturn whence 



The instructions loading the accumulator 
from 37EC and 37E0 accommodate the quirks of 
the TRS-80 hardware — the Z-80's interrupt 
acknowledge signal is not used in this hardware 
scheme. Instead, reading 37EC (disk controller 
status) followed by reading 37E0 (real-time 
clock) resets a flip-flop used to signal input from 
disk controller and real-time clock, respectively. 
This must be done each time or the interrupt 
will continue to be 'on', forcing the routine ever 
back upon itself. 

You may protect memory at 32512 if you wish, 
as this will prevent any accidental crashes while 
you're trying this demo program. Also note that 
if you have installed a disk-disable switch on 
your interface, this program may initially lock 
up. The lockup may be cured by momentarily 
flipping the disable switch on then off. 

So what's the point of this? Only to show that 
no matter what BASIC (or machine language) 
program you are operating, including DOS, the 
sign-on message will remain in the upper-right 
corner of the screen. CLS, scrolling, even 
attempting to overwrite the area with text will 
have no apparent effect, because the interrupt 
takes priority. To disable it, put a RETurn 
instruction in place - 

POKE 16402,201 

and to enable it, replace the return with a 
JUMP: 

POKE 16402,195 

Under DOS, the usual CMD"R" and 
CMD"T" instructions will have their intended 
effect. Re-initializing Level II BASIC or DOS 
from 0000 will wipe out the interrupt patch to 

7F14. 

On to Something Useful 

There are a few rules of thumb for using 
interrupts. First, the interrogation and service 
routines must be as short as possible, or else the 
main program will get little work done between 
interrupts. This means, alas, very few calls to 
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ROM; the ROM calls, although effective, often 
contain a level of detail and error-checking that 
may be beyond the absolute minimum needs of 
the service routine. 

Second, every register to be used by the 
service routine must be preserved, usually on the 
stack, since there is no way of knowing which 
registers will -be in action when an interrupt 
occurs. The only safe bet for ordinary BASIC 
programs using Level II alone is to alternate 
register pairs (by executing EX AF,AF' and 
EXX), since the alternates are not used in Level 
II. IX, however, must still be saved. 

With these thoughts in mind, have a look at the 
listing below, which prints a more useful message 
onto the screen: the BASIC memory available at 
all times. 
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Free memory constant display. 




7F0D 


F3 




SETUP 


01 






7F01A3E C3 






LD 


A.0C3H 




7F03 


32 12 


40 




LD 


!4012HJ,A 


: Setup 


7F06 


21 14 


7F 




LD 


HL, SERVE 


; routine 


7F0B 


22 13 


40 




LD 


(4013H),HL 


; similar 


7F0C 


21 19 


1A 




LD 


HL.1A1SH 


; to that 


7F0F 


E5 






PUSH 


HL 


; presented 


7F1D 


ED SB 






IM 


1 


; above 


7F12 


FB 






EI 






7F13 


C9 






RET 




; 


3C00 






VIDEO 


EQU 


3C00H 




40 EB 






STKBOT 


EQU 


40E8H 




40 FB 






AHRT0P 


EQU 


40FBH 




7F14 


F3 




SERVE 


DI 




; No interrupt 


7F15 


F5 






PUSH 


AF 


■ 


7F16 


E5 






PUSH 


HL 


; 


7F17 


DS 






PUSH 


DE 


; Save aLL 


7F1B 


C5 






PUSH 


BC 


; registers to 


7F19 


00 E5 






PUSH 


IX 


; be used 


7F1B 


FD E5 






PUSH 


IY 




7F1D 


3A EC 


37 




LD 


A.C37ECH) 


; CLear FDC 


7FH0 


3A ED 


37 




LD 


A,(37E0H) 


i CLear F-F 


7F23 


21 69 


7F 




LD 


HL, MESSG 


; Get "MEH=" 


7F26 


11 36 


3C 




LD 


DE.VIDE0+36H 


; PLace to go 


7FE9 


01 05 


DO 




LD 


BC,5 


; Its Length 


7F2C 


ED B0 






LDIR 




; DispLey it 


7F2E AF 






XOR 


A 


; CLear carry 


7F2F 


2A EB 


40 




LD 


HL, (STKBOT) 


i BASIC stack 


7F32 


ED 5B 


FB 


40 


LD 


OE.IARRTOP) 


; Array area 


7F3B 


ED 52 






SBC 


HL.DE 


; Room left 


7F38 


DD 21 


3B 


3C 


LD 


IX.VIDE0+3BH 


; Place to go 


7F3C 


FD 21 


6E 


7F 


LO 


IY, TENTAB 


; Tens-tab Le 


7F40 


D6 OS 






LD 


B,5 


; No. digits 


7F42 


AF 




L00P0 


XOR 


A 


; Clear carry 


7F43 


FD 5E 


00 




LD 


E.IIY+O) 


; 10000 lobyte 


7F46 


FD 56 


01 




LD 


D,(IY+1) 


i 10000 hibyta 


7F49 


B7 




L00P1 


OR 


A 


i Sot flag 


7F4A 


ED 52 






SBC 


HL.DE 


; 1st diffnce. 


7F4C 38 03 






JR 


C, JUHPO 


; If greater 


7F4E 3C 






INC 


A 


; Additive div 


7F4F 


18 FB 






JR 


LODP1 


; Divide egain 


7FS1 


19 




JUHPO 


ADD 


HL,DE 


; Was too much 


7F52 


G6 30 






ADD 


A.30H 


i ASCII cnvrt. 


7F54 DO 77 


00 




LD 


(IX+0),A 


; Display it 


7FS7 


DD 23 






INC 


IX 


; Next screen 


7F59 


FD 23 






INC 


IY 


; Move once, 


7F3B 


FD £3 






INC 


IY 


; end again 


7F5D 


1P E3 






DJNZ 


LODPO 


; Do 5 digits 


7FBF 


FD E1 






POP 


IY 


j 


7FB1 


DD E1 






POP 


IX 


; Restore ell 


7F63 


C1 






POP 


BC 


; the reg's 


7FB4 


D1 






POP 


DE 


; used to do 


7FB5 


E1 






POP 


HL 


; the work 


7FB6 


=1 






POP 


AF 




7F67 FB 






EI 




; Ints. okay 


7F68 C9 






RET 




; BASIC awaits 


7F69 8F 




MESSG 


DEFB 


8FH 


; Block 


7F6A 








DEFM 


'MEH=' 




7F6A 4D 


7F6B 45 


7F6C 


40 7F6D 3D 




7F6E 10 27 




TENTAB 


DEFW 


10000D 


; Tens-table 


7F70 EB 03 






DEFW 


D100DD 


; is used for 


7F72 64 00 






DEFW 


001 ODD 


; division by 
; subtrection 


7F74 0A 00 






DEFW 


0D010D 


7F76 01 00 






DEFW 


00001 D 




7F00 








END 


SETUP 
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The 19-byte interrupt setup routine is found 
as usual, followed by the 100-byte service 
subroutine. All registers are saved — IY is 
optional but may be used by other utilities — a 
message is displayed, and a calculation is made 
to determine free memory. This calculation is 
the bottom of the BASIC subroutine stack 
(referenced at 40E8) minus the top of array 
space (referenced at 40FB). 

Following that is a short, five-digit binary-to- 
ASCII table lookup which, in 35 bytes, converts 
and displays the free memory. 

This routine is especially useful because it can 
help identify the actual area causing out-of- 
memory errors at run time. Heavily nested 
calculations can push the BASIC stack well 
down into memory, which is then visible on the 
screen. Put the program in place, and then try 
this : 

10 GOSUB 20 
20 GOTO 10 

Something Even More Useful 

If you by chance have a printer which prints 
less than 40 characters per second, the following 
routine will speed up your BASIC programs. 
Otherwise, this routine will have little effect on 
your program speed (perhaps a two or three 
percent slowdown), but will allow a program to 
continue without locking up' while the printer is 
in action. It is called a 'spooler', a word which is 
based on an acronym mercifully forgotten. 

When an LPRINT or LLIST is commanded, 
the spooler sends the characters to an in-memory 
buffer, and returns to the waiting program. Since 
255 characters is the maximum string length, this 
buffer size is adequate; increasing it will be 
valuable only if the main program is highly 
interactive, involving user, screen, calculations 
and printer. 

Normally, the LPRINT and LLIST routines 
send a character to the printer, and then check to 
see if the printer is 'busy'. In the meantime, the 
line printer routine is idle, performing no other 
work, and ignoring the BASIC program. Those of 

you with Teletypes know the discouraging 
feeling of waiting for hard copy. 
Instead of waiting for the printer to output the 

entire number, word, or line before returning to 

the program, an interrupt service routine is used 
as a 'despooler'. When the 25-mS interrupt is 
generated, the despooler checks the 255-byte 
buffer to see if a printable character is present. If 
there is, the routine sends that character to the 
printer, advances the buffer, and returns to the 
program in progress. Also, if the printer is busy, 
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Listing 5-4. 



7E00 



Print spooler. 

uoiuu ; Httt*i§t§ttttittittmtmttttttmnttHtmttttttttt 

THIS INTERRUPT SERVICE ROUTINES STORES UP TO 255 CHAR- 
ACTERS IN A BUFFER, WHERE THEY HAY THEN BE OUTPUT TO 
A PRINTER. THIS SPOOLER CHECKS FOR CHARACTERS AT THE 
PRINTER DRIVER ROUTINE, INTERCEPTS THEM, STASHES THEM, 
.AND RETURNS TO THE MAIN PROGRAM WITHOUT DELAY. 

ooieo i t*Mt*ftiHHttimtittttt*tttitttttiMtttttm*t*mt 

00170 ; 



7E00 F3 
7E01 3EC3 
7E03 321240 
7E0B AF 
7E07 47 
7E0B S1BA7E 
7E0B S3 
7E0C 77 
7E0D 10FC 
7EDF 213F7E 
7E12 221340 
7E15 21237E 
7E18 222640 
7E1B 21191A 
7E1E E5 
7E1F ED5B 
7E21 FB 
7E22 C9 



7E23 F3 
7E24 E5 
7E25 78 
7E26 F5 
7E27 21BC7E 
7E2A FB 
7E2B 7E 
7E2C A7 
7E2D 2DFC 
7E2F F3 
7E30 06FD 
7E32 23 
7E33 7E 
7E34 A7 
7E35 2002 
7E37 10FS 
7E39 2B 
7E3A F1 
7E3B 77 
7E3C E1 
7E3D FB 
7E3E C9 



00110 
00120 
00130 
00140 
00150 



7E3F F3 

7E40 F5 

7E41 E5 

7E42 05 

7E43 C5 

7E44 DDE5 

7E4B DD212S40 00830 

7E4A 3AEC37 00B4O 

7E4D 3AE037 

7E50 3AEB37 

7E53 E6F0 



001 BO 

00190 

00200 

00210 

00220 

00230 

00240 

00250 SETUP 

00260 

00270 

002B0 

00290 

00300 

00310 CLEAR 

00320 

00330 

00340 

00350 

00360 

00370 

003B0 

00390 

00400 

00410 

00420 

00430 

00440 

00450 

00460 

00470 

00480 SPOOL 

00490 

00500 

00510 

00520 

00530 

00540 L00P2 

00550 

005S0 

00570 

005B0 

00590 LOOPS 

00600 

00610 

00620 

00630 

00640 SAVEIT 

00650 

006B0 

00670 

00680 

00690 

00700 

00710 

00720 

00730 

00740 

00750 

00760 

00770 SERVE 

00780 

00790 

00800 

OOB10 

00820 



0R6 



7E00H 



mttmttmtmmmmtmtmttmmmtstsMSMst 

SETUP ROUTINE CREATES A BUFFER AND PLACES ITS ADDRESS, 
ALONG WITH A JUMP TO REPLACE THE NORMAL RET, AT 401 2H 

t*t**m***tMtttmtt*ttnttmtinttttttt*tttt*tt**n 

01 i INT. OFF DURING SETUP 

U) A.0C3H ; GET JUMP VALUE INTO A 

LD (4012H),A j PLACE INTO INT. VECTOR 

XOR A j CLEAR ACCUMULATOR 

LD B,A j PUT 100 HEX INTO B 

LD HL.BUFFER-1 j HL JUST AHEAD OF BUFFER 

INC HL j NEXT POSITION IN BUFFER 

LD [HL] ,A j PLACE ZERO INTO BUFFER 

DJN2 CLEAR ; DO IT FULL 256 TIMES 

LD HL, SERVE ; GET SERVICE ROUT. ADDR. 

LD (4013H),HL ; PLACE INTO INT. VECTOR 

LD HL, SPOOL ; GET SPOOL ROUTINE 

LD (4026H),HL ; PLACE IN PRINTER DRIVER 

LD HL.1A19H j RETURN TO BASIC INTO HL 

PUSH HL j PUCE ON STACK 

IM 1 ; SET INTERRUPT MODE 

EI J INTERRUPTS READY TO GO 

RET ; BACK TO BASIC READY 

mtmmmmtmmtmmnmmmtntmtmm 

SPOOL ROUTINE STARTS HERE AND INTERCEPTS PRINTER DRIVER 

mttttHtmttmmtttttttttttttttmtttttttttiimtt 



DI 

PUSH 

LD 

PUSH 

LD 

EI 

LD 

AND 

JR 

DI 

LD 

INC 

LD 

AND 

JR 

DJNZ 

DEC 

POP 

LD 

POP 

EI 

RET 



HL 

A,C 

AF 

HL.BUFFER+1 

A.tHL) 

A 

NZ.L00P2 

B.OFDH 

HL 

A,(HL] 

A 

NZ, SAVEIT 

L00P3 

HL 

AF 

(HL) ,A 

HL 



INT. OFF DURING SPOOL 

SAVE HL REGISTER 
GET CHARACTER INTO A 
SAVE CHAR. TO PRINT 
POINT TO BUFFER START 
INTERRUPTS BACK ON NOW 
GET BUFFER VALUE 
IS IT A CHAR. OR ZERO? 
WAIT IN LOOP IF FULL 
INTERRUPTS BACK OFF 
GET PRESENT BUFFER SIZE 
GET NEXT BUFFER POS'N 
BRING VALUE INTO A 
TEST FOR CHAR. OR ZERO 
FOUND FREE SPACE - GO 
SEARCH THROUGH BUFFER 
BACK OFF ONE POSITION 
RESTORE CHAR. TO PRINT 
PUT IT IN BUFFER 
RESTORE FORMER VALUE 
INTERRUPTS BACK ON 
BACK TO MAIN ROUTINE 



ttttttttmttttnttttttttttmttttttittttttttntsttmt 

INTERRUPT SERVICE ROUTINE FIRST SAVES REGISTERS, THEN 
RESETS INTERRUPT FLIP-FLOPS IN E/I. PRINTER STATUS 
IS EXAMINED, AND THE ROUTINE EXITED IF PRINTER BUSY. 

tt*mt*tmttmtmttimMtmtittmttt*m*ttmu 



7E55 FE30 
7E57 205A 



7E59 21B97F 
7E5C 11BA7F 
7E5F 01FF00 
7E62 EDB8 



00B50 
00B60 
00870 
00880 
00890 
00900 
00910 
00920 
00930 
00940 
00950 
00960 
00970 
00980 
00930 
01000 
01010 



DI 

PUSH 

PUSH 

PUSH 

PUSH 

PUSH 

LD 

LD 

LD 

LD 

AND 

CP 

JR 



AF 

HL 

DE 

BC 

IX 

IX.4025H 

A.137ECH) 

A,(37EDH) 

A,(37E8H) 

OFOH 

30H 

NZ.OUT 



INT. OFF DURING DESPOOL 
SAVE VALUE IN ACCUM. 
SAVE VALUE IN HL 
SAVE VALUE IN DE 
SAVE VALUE IN BC 
SAVE VALUE IN IX 
PRINTER CONTROL BLOCK 
RESET INT. FLIP-FLOP 
RESET INT. FLIP-FLOP 
GET PRINTER STATUS TO A 
MASK OUT LOW BITS 
SEE IF PRINTER IS BUSY 
GO OUT IF PRINTER BUSY 



littmHwmmMttitmtiitmttiiiimttttmtttt 

WHEN PRINTER IS READY, BUFFER IS MOVED UP, THE CHAR- 
ACTER IS TESTED, AND PRINTED IF A VALID CHARACTER. 
IF IT IS CARRIAGE RETURN, FORM FEED, LINE FEED, ETC., 
APPROPRIATE TESTS ARE MADE IN THE PRINTER CONTROL BLOCK 

mHtmttttmttttmtuittttttttttttttmtttttmm 



LD 
LD 
LD 
LDDR 



HL.BUFFER+OFEH 
DE,BUFFER+OFFH 
BC.OFFH 



GET NEXT TO LAST CHAR. 
GET NEXT CHAR. IN QUEUE 
GET TOTAL BUFFER SIZE 
MOVE IT UP ONE POS'N 

Listing Continued . 



it returns to the program immediately. 

A ten-character-per-second (cps) printer like a 
Teletype is 'busy' for 100,000 microseconds for 
each character. In that time, a BASIC program 
might perform many calculations. Selectrics 
type a maximum of 15 cps, which is also time- 
consuming. 

The program will not necessarily benefit in 
time with faster printers, but the waiting period 
will be eliminated in favor of a more interactive 
program overall. 

The following listing is uncommented, as the 
bulk of the interrupt explanations have already 
been presented. The spooler is entered from 
BASIC via LLIST and LPRINT, either of which 
moves directly to the printer driver address 
referenced at 4026 and 4027. This is replaced with 
the address of the spooler. The character to be 
printed is delivered to the printer driver in the C 
register. The spooler searches through the buffer 
for the first non-zero value and places the 
character to be printed immediately before that. 
(If your system requires nulls after a carriage 
return, you can back up the appropriate number 
of places in the buffer). 

Upon interrupt, the despooler saves registers 
and loads the IX register with 4025, the start of 
the printer device control block. This block 
contains line and page information, which is used 
to determine if paging has been completed, and 
how line feeds, carriage returns, and form feeds 
will be handled. It is functionally identical to the 
driver in ROM, except that it takes its characters 
from the spooler's buffer instead of directly from 
the Level II routines. 

If the printer is not busy, then, the character is 
sent to the printer address at 37E8. Following is 
the complete routine, including setup, spool, and 
despool. 

All of the interrupt programs presented in this 
article depend on the expansion interface for 
their 25 mS clock pulses. However, a simple 
rectified and shaped 16.66 mS pulse, which will 
work fine with all of these routines, can be 
created using the 60 Hz output of a 6.3-volt, low- 
current filament transformer, resistor, and 7414 
Schmitt trigger. 

The complete circuit for a printer decoder is 
available from Radio Shack as 'Printer Cable 
Service Manual'. 



The Custom TRS-80 



139 



Continued Listing 



7E64 3ABA7F 
7E67 A7 
7EB8 2849 
7E6A FEOB 
7E6C 2B0A 
7E6E FEOC 
7E70 201F 
7E72 AF 
7E73 DDB603 
7E76 2819 
7E7B DD7E03 
7E7B DD9604 
7E7E 47 
7E7F 3AE837 
7EB2 E6F0 
7E84 FE3D 
7EBB 20F7 
7E88 3E0A 
7EBA 32EB37 
7ESD 10F0 
7EBF 181E 
7E91 47 
7E92 3AEB37 
7E95 E6FD 
7E97 FE30 
7E99 20F7 
7E9B 78 
7E9C 32EB37 
7E9F FEOD 
7EA1 2010 
7EA3 DD3404 
7EA6 DD7E04 
7EA9 DDBE03 
7EAC 79 
7EAD 2004 



01020 

01030 

01040 

01050 

01060 

01070 

01080 

01090 

01100 

01110 

01120 TEST1 

01130 

01140 

01130 LOOPA 

01160 

01170 

01180 

01190 

01200 

01210 

01220 

01230 TEST2 

01240 LOOPS 

01250 

012B0 

01270 

012B0 

01290 

01300 

01310 

01320 

01330 

01340 

01350 

01360 



7EAF 00360400 01370 EXIT 
01380 



LD 

AND 

JR 

CP 

JR 

GP 

JR 

XOR 

OR 

JR 

LD 

SUB 

LD 

LD 

AND 

CP 

JR 

LD 

LD 

DJNZ 

JR 

LD 

LD 

AND 

CP 

JR 

LD 

LD 

CP 

JR 

INC 

LD 

CP 

LD 

JR 

LD 



A,(BUFFER+OFFH) 

A 

Z.OUT 

OBH 

Z,TEST1 

OCH 

NZ.TEST2 

A 

(IX+3) 

Z.TEST2 

A, (IX+3) 

(IX+4) 

B,A 

A,(37E8H) 

OFOH 

3DH 

NZ, LOOPA 

A.OAH 

[37E8HJ ,A 

LOOPA 

EXIT 

B,A 

A,(37EBHJ 

OFOH 

30H 

NZ, LOOPS 

A,B 

(37EBH) ,A 

ODH 

NZ.OUT 

(IX+4) 

A, (IX+4) 

(IX+3) 

A,C 

NZ.OUT 

(IX+4),0 



GET QUEUE CHAR TO PRINT 
TEST TO SEE IF ZERO 
GO OUT IF NONE LEFT 
CHECK IF TOP OF FORM 
TEST IF CHAR. IS ONE 
TEST IF CHAR = F.F. 
NEXT TEST IF NOT 
CLEAR ACCUMULATOR 
GET LINES PRINTED 
OUT IF VALUE = 
GET LINES PRINTED 
GET LINES PER PAGE 
PUT LINES LEFT IN B 
GET PRINTER STATUS 
MASK OUT LOW BITS 
CHECK STATUS BITS 
LOOP IF PRINTER BUSY 
GET LINE FEED CHAR. 
SEND IT TO PRINTER 
DO IT TILL FORM IS FED 
GO OUT WHEN DONE 
STASH CHAR. IN B REG. 
GET PRINTER STATUS 
MASK OUT LOW BITS 
CHECK STATUS BITS 
LOOP TILL PRINTER READY 
GET CHAR. BACK INTO A 
SEND IT TO PRINTER 
CHECK IF CARRIAGE RET. 
IF NOT THEN GO OUT 
ELSE INC. LINES COUNTER 
GET NEW LINES COUNTER 
CHECK WITH LINES/PAGE 
GET CHARACTER BACK TO A 
GO IF NOT PAGE END 
RESET PAGE LINES TO 



7EB3 DDE1 
7ES5 C1 
7EB6 01 
7EB7 E1 
7EB8 F1 
7EB9 FB 
7EBA C9 
OOFF 
7FBA 00 



01390 

01400 

01410 

01420 

01430 

01440 OUT 

01450 

01460 

01470 

D148Q 

01490 

01500 

01510 BUFFER 

01520 

01530 ; 

01540 

01550 



wmmttmtnmttttmtmnmtMtttnttmmtttt 

REGISTERS ARE RESTORED AND THE ROUTINE IS EXISTED. THE 
LAST 255 BYTES OF SPACE ARE RESERVED FOR PRINTER BUFFER 

MtittttttMttMMtttttnttttttttttttttttttttttMttttt* 



POP 

POP 

POP 

POP 

POP 

EI 

RET 

DEFS 

DEFB 



END 



IX 
BC 
DE 
HL 
AF 



255 
00 



RESTORE IX REGISTER 
RESTORE BC REGISTER 
RESTORE DE REGISTER 
RESTORE HL REGISTER 
RESTORE AF REGISTER 
INTERRUPTS BACK ON 
BACK TO MAIN ROUTINE 
DEFINE 255-CHAR. BUFFER 
END BUFFER WITH BYTE 



««««##««»#«#«#««« 



00000 TOTAL ERRORS 

29420 TEXT AREA BYTES LEFT 



BUFFER 


7EBB 


01510 


00300 


00520 009B0 00990 01020 


CLEAR 


7E0B 


00310 


00330 




EXIT 


7EAF 


01370 


01220 




L00P2 


7E2B 


00540 


00560 




L00P3 


7E32 


00590 


00630 




LOOPA 


7E7F 


01150 


011 BO 


01210 


LOOPB 


7E92 


01240 


01270 




OUT 


7EB3 


01440 


0DB90 


01040 01310 01360 


SAVEIT 


7E39 


00640 


00620 




SERVE 


7E3F 


00770 


00340 




SETUP 


7E00 


00250 


01550 




SPOOL 


7E23 


00480 


00360 




TEST1 


7E78 


01120 


0106D 




TEST2 


7E91 


01230 


01080 


01110 
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More Hardware Modifications 

By now your TRS-80 is an electronic in- 
timate. In this chapter, some significant (and 
some sophisticated) hardware modifications will 
be made. A few of these are simple, and their 
value is not immediately obvious. Others 
involve major work (such as the high-resolution 
graphics), but the results are exciting and very 
rewarding. 

Making Halt Work 

Let's start with an easy one. The HALT 
instruction is a useful command. It isn't 
exceptional, but you will find that time spent 
idling in loops waiting for an interrupt is easier 
when the HALT instruction is used. In fact, its 
main advantage comes when the Z-80 
microprocessor is used in interrupt-based 
systems. Where program work is being done, the 
HALT instruction is not particularly 
meaningful; but where program operations are 
suspended except for interrupts, it is very useful. 

When HALT is executed on the Z-80, the 
processor simply ceases program counter 
operation and executes NOPs in order to 
continue memory refresh. That is, the Z-80 
outputs a fetch (the Ml or machine cycle one 
signal) which - together with a refresh address on 
the address bus - constitutes enough information 
to keep the memory active. The information 
received during the fetch is ignored by the CPU, 
which continues to execute NOPs until an 



interrupt is received. It then exits the NOP state 
and services the interrupt. 

Whenever the HALT instruction is executed, 
a halt-acknowledge signal (HALT, active low) is 
output on pin 18. In the TRS-80, pin 18 is tied to 
an input of NAND gate Z53. The other input of 
Z53 is tied high through a 10K resistor, but can 
be pulled low when the Reset button is pressed. 
In other words, either a Reset or a HALT will 
redirect the CPU to the address of the non- 
maskable interrupt (NMI), where it will 
continue execution from either 'READY' or DOS 
reboot. 

By cutting loose pin 18 of the CPU (Z40), and 
tying Z53 pin 2 high, with a 4.7K ohm resistor, the 
HALT instruction will operate as intended by 
the Z-80's designers. Memory will continue to be 
refreshed, as the 4116s' refresh cycle depends on 
RAS (row address strobe), which will be output 
as usual by Z72. 

Cut the trace running from Z40, pin 18. Attach 
a 4.7K ohm resistor from Z53 pin 2, to Z53 pin 14. 
The modification is complete. 

A Real Break 

Later in this Chapter is a power-on monitor, 
which will give more importance to the minor 
change described here. The TRS-80 does not 
have a true 'break' function that resets the CPU 
to its power-up condition. It can be simulated 
by entering SYSTEM followed by /0, or by 
/pressing the Reset button on a disk system. 
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Stuck Relays 



This change is quite simple. Locate Z53, a 
74LS132 NAND gate, which feeds (through Z52) 
the system reset pin of the Z-80 microprocessor. 
When the power is turned on, capacitor C42 
takes time to charge, holding the processor in its 
reset mode for a few milliseconds. When the 
capacitor charges completely, the input to Z53 is 
held high by resistor R47. 

Run a wire from pins 12 and 13 of Z53, through 
a IK resistor, to one end of a SPST (single pole 
single throw) normally open pushbutton switch. 
The other end of the switch goes to ground 
(which can be found at Z53, pin 7). When this 
switch is pressed, the Z53 sees a low signal, and 
resets the processor to address 0000. A resistor is 
used in series so that C42 is not overexerted by 
shorting directly to ground. 

Be sure to mount this button well out of the 
way; for disk systems, it's as fatal as the Reset 
button. For Level II it means MEMORY SIZE? 
and the loss of any program in memory. 

Stuck Relays 

There are two ways to fix a stuck relay: bang it 
until it unstucks, or replace it. The many 
published fixes to tape recorders, or additional 
external circuitry, simply don't take into 
consideration any changes you might make to 
your tape system; nor to the possibility you may 
take your CPU with you when you work 
elsewhere. 

A replacement relay is available from Lab 
Service, Inc., Box 383, Hustisford, Wisconsin 
53034. Unlike the relay normally installed in the 
TRS-80, it is reliable, low power and has gold 
contacts. I have installed this unit in my 
computer, and run the high current motor of a 
CTR-41 through 100,000 operations 
continuously over the course of a week. Neither 
the CTR-41 nor the relay failed. 

The cassette relay is mounted just behind the 
jacks for power, video and cassette. It is a 
cylinder approximately the size of the LSI 
replacement relay, but in most TRS-80s it 
contains six leads instead of four. 

Using solder-wick and a hot soldering iron, 
heat the solder connections and draw off excess 
solder. While doing this, slide a thin flat blade 
under the relay. Take care not to move the 
nearby small video trimmer potentiometers. Use 
the blade as a lever, lifting the old relay off the 
board. Apply very gentle pressure to this lever, 
and alternately melt the three solder connections 
on each side of the relay. Do not use force that 



might crack the board or lift solder traces from 
the board. 

When one side of the relay is completely free, 
grasp it with your hand and pull gently, while 
heating the remaining three connections on the 
opposite side of the relay. It will eventually pull 
free. 

Remove excess solder from the holes with the 
solder-wick. Use a fine splinter to open the eyes 
of the holes, if all the solder does not flow into the 
solder-wick. 

Now examine the circuit board, noting that on 
the end of the relay position nearest the 
computer's connection jacks there are two 
otherwise unused connections; no circuit traces 
run out from these points. Look at the 
relacement relay, noting that it has four wires, 
three on one side and one on the other. Orient it 
above the board so that the unused holes match 
the end of the relay with the single wire. This 
wire feeds into the center of the trio of holes. 

Carefully insert the relay in place; if you have 
properly cleaned out the connection holes, the 
new relay wires will slide in, barely protruding 
from the opposite side of the board. You may 
have to bend them just a bit in order to get them 
to feed through. 

Once the wires are in place, apply a very small 
amount of solder, and secure the relay on the 
board. Check carefully for solder splashes, shorts 
or cracks, and clean or repair them. Such a check 
is doubly important here because the relay driver 
circuit (unlike most other circuits in the TRS-80) 
cannot handle a short circuit for very long. 

Refit the boards and covers of the computer 
together, replace the power and cassette cables; 
then put the cassette player into its play position, 
and enter this program: 



10 PRINT#-1," " 

20 FOR N = 1 TO 500 : NEXT 

30 GOTO 10 



This program will turn the cassette player on 
and off at regular intervals. If it does not work 
properly, double check all connections, 
especially the orientation of the relay, and try 
again. This fix should eliminate any further 
concern over a sticking relay causing skipped 
data or missed program loads. 
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High Resolution Graphics 

Now for the biggie. In the past few years, 
there has been quite a bit of excitement 
generated by the idea of high-resolution 
graphics. Reasonably representative images can 
be drawn .with them, and animation is 
considerably more exciting; especially when 
compared with the extremely high resolution of 
the type used in the latest generation of coin- 
operated video games. The Apple computer was 
advertised with a heavy emphasis on their high 
resolution, hard as it is to work with. The new 
Radio Shack Color Computer also offers several 
modes of resolution. 

The following project can either stand alone as 
a plug-in peripheral, or be integrated as part of 
the TRS-80 keyboard unit. In either case, the 
specifications are: 

1. Resolution of 384 dots wide by 192 dots 
deep. 

2. Full compatability with all current 
software. 

3. Simultaneous use and overprint of 
normal TRS-80 alphanumerics and 
graphics. 

4. Addressing using six bits in contiguous 
memory blocks of 768 bytes each; sixteen 
total memory blocks are used. 

The hardware involved in this project, 
including power supply and miscellaneous 
hardware, will be under $100 (probably closer to 
$70 by the time you read this), yet will compete 
easily with any high-resolution add-on for the 
TRS-80. 

On the negative side, this project will involve 
a great deal of wire wrapping or soldering, and 
will eat up one chunk of 16K memory address 
space when it is used. It will not actually 
compete with or replace the top memory block in 
the expansion box (there is no electronic 
conflict) but will be addressed from COOO 
to FFFF. Alternatively, it may be addressed 
from 8000 to BFFF. In either case, you 
do not need the expansion box to run this 
memory. 



The TRS-80 screen has 1,024 locations in a 
grid of 64 characters across by 16 lines down. 
Within each of these grid elements are blocks 2 



pixels by 3 pixels (a pixel is a 'picture element') 
for the familiar coarse graphics mode accessed 
with SET and RESET. If you turn the contrast 
fully down and reduce the brightness of the 
screen, the individual dots which make up the 
graphic and alphanumeric characters can be seen 
with a sharp eye; a magnifying glass will make the 
dots very clear. 

In order to produce a complete screen line of 
letters, the locations in video memory are handed 
to a circuit which actually accesses them twelve 
times - once for each pass the electron beam 
makes horizontally. At each pass, a row of dots 
corresponding to part of the whole line of letters 
is shifted out to the video beam. Each dot (or 
'undot') then turns the beam on or off for the tiny 
fraction of a second it takes to sweep across 
l/384th of the screen. 

The point is clear: an electronic event takes 
place for every dot on every line of the screen. 
This means that it is possible to create an 
individual, addressable electronic event for each 
screen dot. 

The process might work like this: 

1. Devise a circuit whose timing 
characteristics are identical to the video 
timing of the usual TRS-80 circuits. 

2. Instead of addressing the same video 
memory on twelve consecutive screen lines, 
have the addressing select different memory 
for each line. 

3. Have the contents of that memory filled 
by the TRS-80, and displayed on the same or 
a different monitor. The add-on has its own 
video circuitry, but can be displayed on the 
same monitor because step 1 specifies that 
the timing characteristics must be identical 
to those in the TRS-80. It's like an auto 
with 4-wheel drive, where all wheels are 
capable of working together; or a 
dual-capstan tape recorder, where both 
capstans pull the tape to ensure steady 
contact with the playback head. 



The circuit shown opposite presents the 
complete high-resolution circuitry. There are 
two ways of building this circuit since the areas 
shaded in grey are already present within the 
TRS-80. If you wish, you can solder directly to 
those circuits inside the computer, saving 
yourself some parts and perhaps a bit of time. 
Otherwise, the entire circuit can be built 
separately. » 
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High Resolution Graphics 
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Figure 6-1. Complete high resolution circuit 
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Figure 6-1 b. High resolution memory. 
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Figure 6-1 c. High resolution power supply. 
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Figure 6-2. Hires clock circuit 

Figure 6-2 is the clock. The 10.6445 MHz 
crystal is the same one used in the TRS-80; 
Radio Shack sells it for $3.95, on special order. 
A small trimmer capacitor is included so that 
the frequency of the high resolution board can be 
aligned identically to that in the computer. 

Figure 6-3 is the master video countdown 
chain and timing circuitry, also nearly identical 
to that inside the TRS-80. There are a few 
exceptions. The logic necessary for 32 characters 
per line is not present (it is not needed in high 
resolution mode, although the normal 
alphanumerics may be displayed in 32-character 
mode simultaneously with the hi-res graphics 
screen) . Also, the four outputs of Z6 do not feed 
any latches or character generators; instead, 
they become the line of dots addresses for high 
resolution memory. Identical (top and side) 
screen blanking is used. 

Figure 6-1. is the high-resolution memory 
itself. The familiar 4116 type, 16K dynamic 
memories are used in this circuit (250 nS or less 
is essential), but with a difference. The hi-res 
board must generate its own memory refresh, yet 
hand over control to the TRS-80 when it needs to 
select memory into which it will write 
information. Thus, Z20 multiplexes the on- 
board refresh/select (MRAS, MCAS, MMUX) 
with the TRS-80 select (CRAS, CCAS, CMUX). 

The switch is made by the simultaneous 
presence of addresses 14 and 15 on the address 
bus. 



On-board refresh/select is generated by the 
clock in combination with two flip-flops (Z3a/b), 
producing select in this order: 

1. Z2 pin 8, selects the lowest portion of the 
address; as such, it is the fastest changing 
memory select signal. 

2. Two clock cycles later, Z2 pin 11, 
produces a signal which will be gated by Z9 
and inverted to produce MRAS (row address 
strobe). 

3. One clock cycle later, MMUX goes high, 
produced by the clocking of Z3a. 

4. One clock cycle later, MRAS is continued 
as Z2 pin 11 goes low by Z2 pin 9 going high. 
The transition is simultaneous and virtually 
invisible. 

5. At that time, MCAS is produced when 
Z3b is clocked low at the NOT Q output. 

6. Memory data is stable at this time, and 
two clock cycles later, LATCH is issued by 
Zle, latching the data into Z16 for its trip 
through shift register Z17. 

Figure 6-3 shows the creation of horizontal 
and vertical synchronization signals, and the 
horizontal and vertical screen positioning 
controls. This circuitry again is identical to that 
in the TRS-80, as is Figure 6-4 , the video 
mixing circuitry. 

There is only one critical construction area in 
the device, and that is the circuitry surrounding 
the 10.6445 MHz crystal (Z16, R4-5, Cl). The 
wires in this area must be very short, and all the 
parts clustered together. Capacitor Cl should be 
the only part of the circuit responsible for tuning 
the crystal's frequency, not random capacitance 




.,3 ^ 



SYNC 
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Figure 6-4. The video mixing circuitry. 

introduced by a haphazard bunch of wires. 

Other than the wire layout near the crystal, 
construction is time-consuming but 
straightforward. I recommend wire wrapping 
the entire circuit; use different colors for data, 
address, video, ground, etc., so that 
troubleshooting will be simplified. 

The completed circuit will have these external 
controls: 

1. Power. Three voltages, +5, -5, and +2 
are necessary. -5 volts must be present first 
and last. 

2. Mixing. This controls the intensity of 
the high-resolution board with respect to 
the TRS-80 alphanumerics and graphics. 

3. Fine tuning. This adjusts the 
frequency of the 10.6445 MHz crystal to 
that of the TRS-80. Occasional 
adjustments will be necessary with 
temperature changes. 

4. Vertical and horizontal positioning. 

These control the placement of the image 
on the screen; it should coincide with the 
alphanumeric screen normally produced 
by the TRS-80. 

5. Input. This accepts a cable running 
from the TRS-80 video jack, which would 
normally attach to the video monitor. 

6. Output. This accepts a cable from the 
video monitor, and provides an output 
which mixes the TRS-80 alphanumerics 



and graphics with the high-resolution dots. 

To use the device, attach a 5-pin DIN cable 
between the TRS-80 video jack and the input 
jack hi-res board. Connect the video monitor to 
the output jack of the hi-res board, then attach a 
40-pin edge connector from the TRS-80 to the hi- 
res board. Turn the mixing control fully 
countercockwise (Hi-Res Out). Power up the hi- 
res board, and then the rest of the system in 
normal order. 

As usual, MEMORY SIZE? should appear; if 
so enter 49152 (for a 48K computer). The system 
should operate as usual. Enter the following 
program: 

10 FOR X = 15360 TO 16383 

20 POKE X.120 

30 NEXT 

40 FOR X = -163B4 TO 

50 POKE X.175 

60 NEXT 

70 GOTO 70 

The screen will fill with small graphics blocks. 
There will be a pause of almost a minute while 
the rest of the program is running. Put an AM 
radio next to the computer to determine when 
the program is complete. Now bring the mixing 
control of the hi-res board clockwise until dots, 
herringbone, jitter and/or other interference 
appears on the screen. This is a good sign. 

If you have a stable enough screen to see the 
alternating dot patterns produced by the hi-res 
board, then adjust the horizontal and vertical 
positioning controls, if necessary, to center the 
image with that of the TRS-80. To remove the 
jitter and herringbone adjust the fine tuning 
control. 

Now your screen should display an alternating 
pattern of TRS-80 graphics, along with an 
overlay of thin vertical lines of hi-res graphics 
dots. If you have any difficulty getting this 
pattern, or if there are any other problems, refer 
to the troubleshooting section. 

Use of the Hi-Res board is simple. Addresses 
from C000 through C03F contain the information 
to create the first line of dots, addresses C040 
through C07F contain the second line, etc. A 
contiguous block of memory from C000 through 
C2FF is used for the first twelve lines of dots. But 
since the display is twelve lines, and not sixteen, 
the addressing takes a jump in order to be 
compatible with the familiar 64 x 16 normal 
screen display. Thus, addresses C300 through 
C3FF are not used, and the second group of 12 
dot lines begins at address C400 and continues 
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through C6FF. Here is a full memory map of the 
Hi-Res board: 

Hi-Res Board Memory Hap 



CODD 


- CD3F 


Group 


1, Line 1 , 


Screen 


Line 1 


C040 


- CD7F 


Group 


1, Line 2, 


Screen 


Line 2 


COBO 


- COBF 


Group 


1, Line 3, 


Screen 


Line 3 


CDCO 


- COFF 


Group 


1, Line 4, 


Screen 


Line 4 


C10D 


- C13F 


Group 


1 , LinB 5, 


Screen 


Line 5 


G140 


- C17F 


Group 


1 , Line 6, 


Screen 


Line 6 


C18D 


- C1BF 


Group 


1, Line 7, 


Screen 


Line 7 


C1C0 


- G1FF 


Group 


1 , Line 8, 


Screen 


Line 8 


02oa 


- C23F 


Group 


1 , Line 9, 


Screen 


Line 9 


C240 


- C27F 


Group 


1, Line 10 


Screen Line 10 


C280 


- C2BF 


Group 


1, Line 11 


Screen Line 11 


C2CD 


- C2FF 


Group 


1, Line 12 


Screen Line 12 


C400 


- C43F 


Group 


2, Line 1, 


Screen 


Line 13 


C440 


- C47F 


Group 


2, Line 2, 


Screen 


Line 14 


C68D 


- OBBF 


Group 


2. Line 11 


Screen Line 23 


C6CD 


- C6FF 


Group 


2, Line 12 


Screen Line 24 


CBOO 


- CAFF 


Group 


3, Lines 1 


- 12 








Screen Lines 25 - 


- 36 




CCDO 


- CEFF 


Group 


4, Lines 1 


- 12 








Screen LlnBS 37 - 


- 48 




DDOD 


- D2FF 


Group 


5, Lines 1 


- 12 








Screen Lines 49 - 


- 60 




D40D 


- D6FF 


Group 


6, Lines 1 


- 12 








Screen Lines 61 - 


- 72 




D800 


- DAFF 


Group 


7, Lines 1 


- 12 








Screen 


Lines 73 - 


B4 




DCOQ 


- DEFF 


Group 


8. Lines 1 


- 12 








Screen 


Lines B5 - 


96 




EQOO 


- E2FF 


Group 


9, Lines 1 


- 12 








Screen 


Lines 97 - 


10B 




E400 


- EBFF 


Group 


10, Lines 1 


- 12 








Screen 


Lines 109 


- 120 




E800 


- EAFF 


Group 


11 , Lines 1 


- 12 








Screen 


Lines 121 


- 132 




EO00 


- EEFF 


Group 


12. Lines 1 


- 12 








Screen 


Lines 133 


- 144 




F000 


- F2FF 


Group 


13, Lines 1 


- 12 








Screen 


Lines 145 


- 156 




F400 


- F6FF 


Group 


14, Lines 1 


- 12 








Screen 


Lines 157 


- 168 




FBOO 


- FAFF 


Group 


15, Lines 1 


- 12 








Screen 


Lines 169 


- 180 




FCOO 


- FEFF 


Group 


16, Lines 1 


- 12 








Screen 


Lines 181 


- 192 





Before continuing, clear out the hi-res 
memory with: 

FOR X = -16384 TO : POKE X,0 : NEXT 

Drawing simple lines is an easy process; for a 
horizontal one, just enter: 

FOR X = -12288 TO -12224 : POKE X, 63 : NEXT 

A vertical one is produced by stepping through 
groups: 



5 CLS 

10 FOR Y = -16352 TO O STEP 1024 

20 FOR X = Y TO Y+C 12*64) STEP 64 

30 POKE X,1 : NEXT X 

40 NEXT Y 

50 GOTO 50 



REM KILL ALPHANUMEHICS 

REM STEP THROUGH GROUPS 
REM STEP THROUGH LINES 
REM SET ONE PIXEL 
REM TO NEXT LINE GROUP 
REM KEEP DISPLAY INTACT 



Diagonal lines are more complicated, because 
more than two sets of increments must be 
specified; but simple diagonals can be created. 
For diagonals and variable-width lines, change 
listing to read as follows: 



10 INPUT a : INPUT R : CLS 

20 FOR Y = -16352 TO STEP 1024 

30 FOR X = Y TO Y+[12*64! STEP 64+0 

40 POKE X,(R AND 63) : NEXT X 

50 NEXT Y 

60 GOTO 80 



For serious graphics, assembly language 
programming is the only way real speed can be 
achieved. This is a very 'custom' type of 
programming, and only the simplest of 
subroutines will be presented here. For drawing 
circles, ellipses, and curves the functions will 
have to be stored in a look-up table and 
calculated. Listing 6-1 is an assembly listing 
to draw graphic lines on the screen, given a set of 
coordinates. 



Only six bits of each byte are used (the least 
significant six); thus, six one-bit-wide, memory 
chips are used in the circuit. The bits fit into 
their respective lines and memory addresses as 
follows: 



DDT ROW 
ONLY USED- 
IN HEW 



USED IN 
GRAPHICS 
MODE ONLY 



DOT COLUMN 
HOT USED 
IN ALPHA 





1 


ooo 
©•O o 
#00 

® 


000 
o®o 

90 

#00 


00® 
# 

® 
• 


000 

soo 
# 
®o 


oooo 
oooo 
oooo 


000 
000 
000 

000 







FULL 

SCREEN 

[1034 BYTES! 





- « n * w 






h- 1- 1- t- t- t- 






a a a a a ta 




cooo 


O OOOOO 


C001 ►■ C03F 


C040 


OOOOOO 




C080 


000000 






coco 


OOOOOO 






C100 


00 OOOO 






C140 


00 oooo 






ciao 


00 oooo 






C1CO 


00 oooo 






C200 


00 oooo 






C240 


00 oooo 


' 




C280 


00 oooo 








*»w 


C400 






f 
C6C0 
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S3 ?K : ****iH"***'*************************ttmmtttt*tttt 

OD110 ; ROUTINE TO DRAW HORIZONTAL AND VERTICAL LINES FR. BASIC 

001 2D ; Htttm*mtmmttmtttttttttttttttttttmnmtttt 

00130 ; 



cooo 


00140 HIRES 


EQU 


OCOOOH 


S START OF HIRES GRAFIX 


0A7F 


001 SO XFER 
00160 : 


EQU 


0A7FH 


; VARIABLE XFER ROUTINE. 


7F00 


00170 
00180 




ORG 


7F00H 


i SOMEWHERE IN MEMORY 




00190 


', mmttttttmmmttmmtttmttmtmmtitttm 




00200 


; SUBROUTINE TO 


DETERMINE THE CORRECT BASIC USR(X) CALL 




00210 
00220 


; mtmmtttttttttttttttttimtmtttttttmtmmm 


7FJD0 CD7FDA 


00230 


ENTRY 


CALL 


XFER 


; GET VALUE FROM BASIC 


7F03 7C 


00240 




LD 


A,H 


i GET MSB INTO ACCUM. 


7F04 B5 


00250 




ADD 


A,L 


; ADD LSB FROM HL PAIR 


7F0S A7 


00260 




AND 


A 


; TEST IF IT IS ZERO 


7F06 280B 


00270 




JR 


Z.PCLS 


; CLEAR SCREEN ROUTINE 


7F0B FE01 


00280 




CP 


1 


; TEST IF IT IS ONE 


7FDA 2B15 


00280 




JR 


Z.PHORIZ 


; HORIZONTAL LINE ON 1 


7F0C FE02 


00300 




CP 


2 


; TEST IF IT IS A TWO 


7F0E 283D 


00310 




JR 


Z.PVERT 


i VERTICAL LINE ON 2 


7F1D C39719 


00320 
00330 




JP 


1997H 


i SN? ERROR IF NOT 1,2,3 




00340 


#«## 


nmmmtmtttmttttmttmtnttmmmm 




00350 


SUBROUTINE TO 


CLEAR THE SCREEN IN HIGH-RESOLUTION MODE 




00360 


BASIC 


FORMAT: 


M=USR[A). A MUST ALWAYS BE ZERO. 




00370 


ttttt 


mtmmmmttt*t*m*tt**tmttnmttttm*t 




00380 










7F13 AF 


00390 ( 


'CLS 


XOR 


A 


i GET CHARACTER TO WRITE 


7F14 F5 


00400 




PUSH 


AF 


; SAVE THAT CHARACTER 


7F15 2100CD 


00410 




LD 


HL, HIRES 


: GET BEGINNING OF HI-RES 


7F1B F1 


00420 I 


'CLEAR 


POP 


AF 


; RESTORE ZERO CHARACTER 


7F19 77 


00430 




LD 


(HL),A 


: PUT IT IN PUCE IN MEM 


7F1A F5 


00440 




PUSH 


AF 


; SAVE CHARACTER AGAIN 


7F1B 7C 


004S0 




LD 


A,H 


: GET MSB OF CURRENT LOC. 


7F1C BS 


00460 




OR 


L 


i GET LSB AND TEST PAIR 


7F1D 20F9 


0D470 




JR 


NZ.PCLEAR 


i LOOP BACK FOR NEXT 


7F1F F1 


00480 




POP 


AF 


i GET STACK BACK IN SHAPE 


7F20 C9 


00490 
00500 




RET 




: BACK TO CALLING ROUTINE 




00510 


**t*tHMttttttttt*t*t*tt***t*t*Mtt*tttt*t**t*t**tt*tt 




00520 


SUBROUTINE TO 


DRAW A HORIZONTAL LINE. BASIC FORMAT: 




00530 


POKEN 


,B:C1=INT(C/6] :C2=C-C1*6 


POKEN+1 ,C1 :P0KEN+2,C2: 




00540 


D1=INT(D/6) :D2=D-D1*6:P0KEN+3 


D1:P0KEN+4,D2:M=USR(1! 




00550 












00560 


B=LINE NUMBER 


10-11, 16-27, 32-43, 48-59. 64-75, 80-81. 




00570 




96-107, 


112-123, 128-13S 


. 144-155, 160-171, 176- 




00580 




187, 192-203, 208-219, 224-235, 240-251 




00590 


C=ORIGINATION 


POSITION (0-383) 


, 




00800 


D=DESTINATION 


POSITION (0-383) 


. C MUST BE LARGER THAN D 




00610 


####################«######« 


n*tt*t*tmti*ttmt*ttt 




00620 










7F21 DD21897F 


00630 F 


HORIZ 


LD 


IX, N 


; POINT TO THE STORAGE 


7F25 CD6E7F 


00640 




CALL 


FINDER 


i GET STARTING POSITION 


7F28 3ABC7F 


00650 




LD 


A,(N+3) 


; GET VALUE AT "N+3" 


7F2B 4F 


00660 




LD 


C.A 


i PUCE IN MSB OF BC 


7F2C AF 


00670 




XOR 


A 


i CLEAR ACCUM TO ZERO 


7F2D 47 


00680 




LD 


B,A 


; PUCE IN LSB OF BC 


7F2E E5 


00690 




PUSH 


HL 


; SAVE START LOC'N 


7F2F D5 


00700 




PUSH 


DE 


; READY FOR XFER BACK 


7F30 E1 


00710 




POP 


HL 


; TRANSFERRED BACK 


7F31 09 


00720 




ADD 


HL.BC 


; PERFORM THE ADDITION 


7F32 ES 


00730 




PUSH 


HL 


; READY FOR TRANSFER 


7F33 D1 


00740 




POP 


DE 


; AND GET INTO DESTIN'N 


7F34 E1 


00750 




POP 


HL 


i RESTORE ORIGINAL VALUE 


7F35 3ABB7F 


00760 




LD 


A,(N+2) 


; GET VALUE AT "N+2" 


7F3B BB 


00770 




OR 


(HL) 


; ADD TO CURRENT LOC'N 


7F39 77 


00780 




LD 


(HL1 ,A 


: AND PUT INTO PUCE 


7F3A 23 


00790 




INC 


HL 


i NEXT SCREEN POSITION 


7F3B AF 


00800 I 


00P1 


XOR 


A 


; CLEAR ACCUM TO ZERO 


7F3C 3A3F0D 


00810 




LO 


A,(03FH) 


; VALUE TO FILL BYTE 


7F3F ED52 


00820 




SBC 


HL.DE 


; PERFORM SUBTRACTION 


7F41 2B04 


00B30 




JR 


Z,H0ROUT 


i OUT OF ROUTINE 


7F43 77 


00840 




LD 


(HL) ,A 


; PUT BYTE IN PUCE 


7F44 23 


0Q850 




INC 


HL 


; GET NEXT SCREEN POS'N 


7F4S 1BF4 


00860 




JR 


L00P1 


; GO BACK FOR NEXT FILL 


7F47 3A8D7F 


00B70 V 


OROUT 


LD 


A,(N+4) 


; GET BACK FINAL BYTE 


7F4A B6 


00880 




OR 


(HL) 


i ADD TO VALUE ON SCREEN 


7F4B 77 


00890 




LD 


(HL),A 


; PUT IT ON THE SCREEN 


7F4C C9 


00900 
00910 ; 




RET 




; AND BACK TO BASIC 




00920 , 


*t***tt*i*t*tt*tmtt*ttttttttmttn**t*tt*tnmmttt 




00930 


SUBROUTINE TO 


DRAW A VERTICAL 


LINE. 48K RAM IN PUCE. 




00940 , 


BASIC 


FORMAT: 








00950 , 


POKEN 


,B:C1=INT[C/6] :C2=C-C1»6: 


POKEN+1 ,C1 :PQKEN+2,C2 




00960 , 


01 =INT ( D/6 ) : D2=D-D1 »6 : POKEN+3 , 


D1 :P0KEN+4,D2:M=USR(2) 




00970 ; 












00980 ; 


E=HORIZONTAL POSITION (0-255) 






00890 ; 


F=LINE NUMBER 


(SEE HORIZONTAL LINE, ABOVE) 




0100Q j 


G=LINE NUMBER 


(SEE HORIZONTAL 


LINE, ABOVE) 




01010 j 


ntttttttttttttttttttttttttmttttttmtttttmtttmtt 




01020 ; 










7F4D DD21897F 


01030 F 


VERT 


LD 


IX, N 


; POINT TO THE STORAGE 



Listing 6-1. Hires demonstration program. 



Listing Continued . 



Without TRS-80 memory parallel to that in 
the hi-res board, it is not possible to read the 
contents of the high-resolution memory directly. 
The contents must be stored in some form 
elsewhere. When the high 16K block is in place 
in the expansion box, however, six bits of each 
byte are identical to those on the screen. Ideally, 
the entire block of high resolution memory (16K 
by 6 bits) and TRS-80 memory (16K by 8 bits) 
should be cleared out by POKEing in place 
first. Then an in-computer image of the high 
resolution screen can be maintained at all times. 

Another interesting mode of using the high 
resolution board is with a separate screen. 
Normal alphanumerics can appear on the TRS- 
80 monitor, while the high-resolution graphics 
can be presented on a parallel screen. This way, 
the table calculations and information reported 
can be displayed on the computer's monitor for 
reference. The high-resolution screen will be 
unaffected by anything done by the TRS-80 
unless its memory is being specifically written 
to. Not only can action games of the Startrek 
type be more interesting and challenging — with 
visuals and info displayed on different screens — 
but for experimentation and analysis, the high- 
resolution display is unbothered by program 
changes. 

To use this mode, merely leave your TRS-80 
monitor plugged into the computer. Then send 
the video information in the hi-res board to 
another video monitor, or to an ordinary 
television set via an RF modulator. 

Troubleshooting 

With a complicated project like this, there is a 
good chance that the system will not work 
perfectly the first time. The main problems 
together with their causes and solutions are 
outlined below. 

1. The screen keeps tearing or jittering no 
matter what setting the fine tuning is on. 
If the fine tuning has no effect at all, it may 
be defective. Replace it. If the tuning gets 
better, but can't quite pull it in, you can 
put another capacitor in parallel to 
increase the capacitance, or replace the 
crystal (in either the hi-res board or the 
TRS-80) with one better matched to the 
other. 

2. The high-resolution graphics cannot be 
changed, remaining the same as when the 
power was turned on. The memory write 
circuits are not working properly. Check 
the memory-select wiring at Z20; the write 
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Continued Listing 



7F51 CD6E7F 


01040 




CALL 


FINDER 


; GET SCREEN START BYTE 


7FS4 E5 


01050 




PUSH 


HL 


SAVE THE START VALUE 


7F55 DD21BC7F 01060 




LD 


IX.N+3 


POINT TO THE TABLE 


7F59 CD6E7F 


01070 




CALL 


FINDER 


AND DO THE WORK 


7FSC E5 


010B0 




PUSH 


HL 


READY VALUE TO TRANSFER 


7F5D D1 


01090 




POP 


DE 


AND TRANSFER TO DEST'N 


7FSE E1 


01100 




POP 


HL 


RESTORE START POSITION 


7F5F 014000 


01110 




LD 


BC.40H 


SCREEN BYTE LINE OFFSET 


7F62 AF 


01120 




XOR 


A 


CLEAR CARRY FLAG 


7FB3 3ABB7F 


01130 




LD 


A,tN+2) 


GET BYTE FROM STORAGE 


7FB6 77 


01140 


L00P2 


LD 


CHL] ,A 


STASH IT ON SCREEN 


7FB7 09 


01150 




ADD 


HL.BC 


HOVE UP ON THE SCREEN 


7F6B ED52 


01160 




SBC 


HL.DE 


CHECK IF DONE YET 


7FBA 80FA 


01170 




JR 


NZ.L0QP2 


BACK IF NOT DONE 


7F6C 77 


011 BO 




LD 


(HL) ,A 


PUT LAST BYTE IN 


7FBD 09 


01190 
01200 




RET 




BACK TO BASIC 




01210 


I tt**tt*tttttttt*tititttttt*tttmtmtittttttt**ttttm 




01220 


; FINDER SUBROUTINE LOCATES PROPER BYTE WITHIN HIRES ARB! 




01230 


; ttttttttttttttmttttmtttnttttttntttttttttttttttttt 




01240 










7FBE 21D0C0 


01250 


FINDER 


LD 


HL, HIRES 


GET HI-RESOLUTION SCRN 


7F71 DD7E00 


01260 




LD 


A, (IX) 


BET START BYTE OFFSET 


7F74 47 


01270 




LD 


B.A 


PLACE IN B REGISTER 


7F75 AF 


01280 




XOR 


A 


CLEAR THE CARRY FLAG 


7F76 CB1B 


01290 




RR 


B 


DIVIDE BY TWO AND ... 


7F78 CB19 


01300 




RR 


C 


... ROTATE IN ORDER ... 


7F7A CB18 


01310 




RR 


B 


. . . ACTUALLY TO . . . 


7F7C CB19 


01320 




RR 


C 


... MULTIPLY BY 64 


7F7E 09 


01330 




ADD 


HL.BC 


MAKE NEW SCREEN POS'N 


7F7F E5 


01340 




PUSH 


HL 


READY IT FOR TRANSFER 


7FB0 D1 


01350 




POP 


DE 


TRANSFER TO DESTIN'N 


7FB1 DD7E01 


01360 




LD 


A,tIX+1) 


GET START BIT OFFSET 


7F84 4F 


01370 




LD 


C,A 


PLACE IN MSB OF BC 


7FBS AF 


013B0 




XOR 


A 


CLEAR ACCUM TO ZEHO 


7FB6 47 


01390 




LD 


B.A 


PLACE IN LSB OF BC 


7FB7 09 


01400 




ADD 


HL.BC 


GET NEW START BIT 


7F8B 09 


01410 
01420 




RET 




BACK TO CALLING ROUTINE 


7FB9 


01430 
01440 


N 


EQU 


$ 


MOMORY STORAGE POS'NS 


06CC 


01450 




END 


06CCH 


BACK TO BASIC 


00000 TOTAL 


ERRORS 










30026 TEXT AREA BYTES LEFT 






ENTRY 7F00 


00230 










FINDER 7F6E 


01250 


00640 


01040 01070 




HIRES C000 


00140 


0041 


01250 






HDROUT 7F47 


00870 


00830 








LOOP1 7F3B 


OOBOO 


00B60 








L00P2 7F66 


01140 


01170 








N 7F89 


01430 


00B30 


00650 007B0 00B70 01030 011 


380 01130 


PCLEAR 7F1B 


00420 


00470 








POLS 7F13 


00390 


00270 








PHORIZ 7F21 


00630 


00290 








PVERT 7F4D 


01030 


00310 








XFER 0A7F 


00150 


00230 









lines to the memory (Zll); and the write 
line from the computer (from edge card pin 
13). 

3. The high-resolution graphics keep 
changing without writing to them. The 
memory-select circuits may be selecting 
write for both read and write; check Zll. 
More likely, the memory refresh/select 
circuitry is miswired; check Z9a and Z3. 

4. When creating lines of graphics, the dots 
do not appear in the correct place. This 
indicates the memory data and /or address 
lines are miswired; check the lines from the 
computer (pins 4-7, 9-11, 17-18, 20, 22, 
24-28, 30-32, 34-36, 38 and 40), making sure 
they are in the correct order. Also check 
each memory circuit to be sure the address 
lines (pins 4-7, 10-13, and 15) are parallel in 
each memory IC. Finally, be sure Z4 
correctly feeds Z10; Z5 correctly feeds Zll; 
Z6 correctly feeds Z12; and Z7 correctly 
feeds Z13. These four circuits are the 
memory count/multiplex circuits. Also 
check that Z10, 11, 12 and 13 correctly feed 
Z18 and 19. 

5. No graphics are produced. This is a 
tough one. The fault could lie with 

(a) the clock formed by Zla-c 

(b) the memory refresh circuits Z9b and Z3 

(c) latch and shift registers Z16 and Z17 

(d) memory circuits Z21 to Z26 

(e) video output formed by Z30, Ql and Q2. 

Check the screen display carefully, because if 
any of these sections are working (except the 
video output) the screen will be affected in some 
way, even if it is minor. If herringbone or some 
tearing is present when the fine tuning is 
adjusted, then the video output and sync 
circuits are probably okay. Also, be sure that 

the mixing control is not turned fully 
counterclockwise (TRS-80 on, hi-res off). 

6. The computer crashes to MEMORY 
SIZE? or otherwise acts problematically. 
The hi-res board has no effect on the 
computer. No data is written to the 
computer from the hi-res board at any 
point; it only receives information. If the 
computer crashes, then faulty wiring is 
likely. 
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Hires Graphics Example 







in 



mm Wmm 

■r.,^ : "" -;.•;■■:■ . ■ •■"Vi-..': ■'••.■. ••• ■ - • "^^^"^^^i^wfe^felES^^^ 



H 




P/zoto 6-i. Hi- Res graphics example. 
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Replace BASIC ROMs 



Replace BASIC ROMs 

In the past few years, more and more TRS-80 
users have asked me the question, "I don't need 
BASIC because I do all my work in machine 
language. How can I use that space for my own 
routines and language in ROM?". The answer is 
simple: replace your ROMs with 2716 (2K x 1 
byte), 2732 (4K x 1 byte) or 2764 (8K by 1 byte) 
EPROMs. 

The process is electronically simple. The Level 
II (or Level I) ROMs are removed, and a board 
containing the new and old ROMs is inserted at 
the edge connector. This board, then, can select 
either ROMs at the flick of a switch - exactly like 
the Apple's 'softcards' do it. 

This section will present a circuit to use 2716 
EPROMs and any other ROMs together and, as a 
bonus, a way to hand control of your TRS-80 over 
to another microprocessor! The power of such 
processors as the 6502, 6800 series, the 8060 
(SC/MP) and others then becomes available to 
the TRS-80 user. Together with the appropriate 
bootstrap and executive programs in ROM, the 
TRS-80 can act with the strengths of almost any 
language and almost any processor. 



There is no secret to adding ROM. The area 
from 0000 to 37C0 is free to use, and some of that 
method has already been presented. Figure 6-5 
presents the circuitry that will handle seven 2716 
EPROMs, switchable with the 3-chip Level II 
ROM set. 

The real trick is making another processor 
available to the TRS-80's hardware. This other 
processor must be able to: 

- access memory and peripherals in the 
TRS-80 memory map 

- address at least 32K of memory 

- be able to move its software stack 
anywhere in memory 

- refresh the 4116 dynamic memories. 

Of these restrictions, the last two are the 
trickiest. Without also placing RAM on this 
outboard device, the 6502 cannot be used, 
because it requires its stack in page 1 (0100-01FF) 
and many of its fastest (and hence most 
advantageous) instructions are limited to page 
(0000-00FF). 




Figure 6-5. Circuit for replacing BASIC ROMs. 



1 . REMOVE DIP SHUHT Z3 . 

2. ALL SEVEN 271 B'S ARE CONNECTED IN 
PARALLEL EXCEPT PIN 18. 
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Power-Up Monitor 



However, the refresh requirement is the most 
severe. Because the RAS-only refresh is 
controlled within the TRS-80, and its signals are 
killed when the processor is removed, the entire 
refresh process must be handled outside the 
computer by chips which were not designed for 
dynamic memory support. 

Before turning to the details, you may be 
asking "How can control be wrested from the Z- 



80?". The answer is found in the line marked 
TEST. This input line is present on pin 23 of the 
TRS-80 bus, and when brought low, causes all 
address lines (A0-A15), all data lines (D0-D7), 
read (RD), write (WR), input (IN), output 
(OUT), row address strobe (RAS), column 
address strobe (CAS) and memory select 
multiplex (MUX) to be put into three-state 
condition. This provides a wide-open computer 
bus for the outside world. 



Power-Up Monitor 



> 






i 3 S 




jj» Z3B 

PIN 4 






— X- 




POWER UP TO K3HXTQR 


AT 


3000 II 




MONITOR HUST EXECUTE 








3Q0Q C3033Q 




JP 


3D03H 


3003 AF 




XQR 


A 


3004 0300 




OUT 


(0),A 



Figure 6-6. Modification needed for power-up monitor. 



From my programmer (but not my user!) 
point of view, entering BASIC immediately 
upon power-up, or reset, is inconvenient and 
sometimes maddening. Rather, I would prefer a 
jump to a monitor of the type which can be 
found on the Ohio Scientific microcomputers: 
instead of MEMORY SIZE?, the user is 
presented with 'D/C/W/M?', which means 'Disk 
reboot, Cold start in BASIC (MEMORY 
SIZE?), Warm start in BASIC (READY), or 
Machine Language Monitor?'. 

The user can exit from BASIC to the monitor 
and back at any point without jumping to a 
program-creaming MEMORY SIZE? The cold 
start serves that purpose, and is almost always 
by choice. 

There is such a possibility on the TRS-80, so 
long as two conditions are met: 

1. A machine language monitor is resident, 
preferably in ROM. 

2. The restart from 0000 is redirected from 
BASIC to that machine language monitor, 
and/or the NMI located at 0066 is redirected 
to that machine language monitor. This 
latter configuration preserves the last 
location of the program counter on the stack 
for examination. 



The first requirement is easy to meet, and is in 
my opinion the most logical use of a ROM 
memory addition. 
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401A 
3000 



3D00 
3DD1 
3005 
3008 
3009 
300A 
300B 
300C 
300F 
3012 
3015 
3017 



3019 
301C 
301F 
30E8 
3035 
3QS7 
3029 
3Q2B 
302E 
3030 
3032 
3034 
3036 
3038 
303A 



303C 
303D 
303E 
3040 
3043 
3046 
3049 
304B 
304C 
304D 
304F 
3051 
3052 
3053 
3055 



F3 

ED73E242 

31E042 

F5 

C5 

05 

E5 

21003C 

11013C 

01FFD3 

36S0 

EDBO 



219732 

11C03C 

CD8F32 

CD0331 

FE63 

2813 

FE64 

CA0000 

FE6D 

2830 

FE75 

2822 

FE77 

28 2A 

1BE6 



F3 

AF 

D3FF 

210206 

110040 

013600 

EDBO 

3D 

3D 

20EF 

0627 

12 

13 

10FC 

C37500 



3058 E1 

3059 D1 
305A G1 
305B F1 

30SC ED7BE242 

3060 2A8E40 
3063 E9 



3064 E1 

3065 D1 

3066 C1 

3067 F1 

3068 ED7BE242 
306C C3CC06 



00100 

00110 

00120 

00130 

00140 

00150 

00160 

00170 

001 BO 

00190 

00200 

00210 

00220 

00230 

00240 

00250 

00260 

00270 

002B0 

00290 

00300 

00310 

00320 

00330 

00340 

00350 

00360 

00370 

00380 

00390 

00400 

00410 

00420 

00430 

00440 

00450 

00460 

00470 

00480 

00490 

00500 

00510 

00520 

00530 

00540 

00550 

00560 

00570 

005B0 

00590 

00600 

00610 

00620 

00630 

00640 

00650 

00660 

00670 

00680 

00690 

00700 

00710 

00720 

00730 

00740 

00750 

00760 

00770 

00780 

00790 

00800 

00810 

00B20 

00830 

00840 

00B50 

00860 

00870 

00BB0 

00890 

00900 

00910 

00920 

00930 

00940 

00950 

00960 

00970 

00980 

00990 

01000 

01010 



; t*tMttttt*ttittt***mt*tt**mttmtt*tttmttt*ttt*t 

; POWER-UP PROGRAM FOR USE INDEPENDENTLY (WITHOUT .BASIC 
i ROMS IN PLACE) OH IN CONJUNCTION WITH EXIT AND RE-ENTRY 
i TO BASIC UP RESET TO 0000 [BEFORE DISC SYSTEM REBOOT!. 

: Htmnttttttnttnttttttnttttttttttitttttnttttttttt 



KPLACE EQU 
ORG 



401AH 
3000H 



RAM STORAGE FOR STROKE 
MONITOR ENTRY POINT 



; tmttmttmmmmmmmtmnm*mmtmtn 

; OPTIONAL SCREEN-CLEAR. IF THE EXIT CONDITION OF THE 
; SCREEN IS IMPORTANT, THEN ELIMINATE CLEARING PROCESS 

: ttttttmmtmtt*»ttt*ttmt*Mtttttttt*tttnt*tttttt 



01 




i KILL THE INTERRUPTIONS 


LD 


(42E2H),SP 


; SAVE STACK POINTER 


LD 


SP.42E0H 


; GET NEW STACK POINTER 


PUSH 


AF 


; SAVE REGISTERS FOR 


PUSH 


BC 


; LATER DISPLAY 


PUSH 


DE 


; DURING THE 


PUSH 


HL 


| MONITOR ENTRY 


LD 


HL.3C00H 


; BEGINNING OF SCREEN 


LD 


DE.3C01H 


; NEXT POSITION ON SCREEN 


LD 


BC.3FFH 


; NUMBER OF SCREEN POS'NS 


LD 


(HL),20H 


; PRINT SPACE 1ST POS'N 


LOIR 




; DO IT FOR WHOLE SCREEN 



LD 


HL.MSG01 


LD 


DE.3CC0H 


CALL 


DISPLY 


CALL 


INPUT 


CP 


63H 


JR 


Z.COLD 


CP 


64H 


JP 


Z.0000 


CP 


6DH 


JR 


Z.MONTOR 


CP 


75H 


JR 


Z.USER 


CP 


77H 


JR 


Z.WARM 


JR 


MENU 



CLS 



ttttttttttttttMMtttttitttttttttmttttttttttttttttMW 
DISPLAY DISK/MONITOR/WARM START/USER ROUTINE MESSAGE 



GET FIRST MESSAGE 
GET DISPLAY POSITION 
AND DISPLAY ON SCREEN 
GET INPUT FROM KEYBOARD 
IS IT A LETTER "C"? 
GO TO COLDSTART ROUTINE 
IS IT A LETTER "0"? 
GO TO DISK REBOOT 
IS IT A LETTER "M"? 
GO TO MACHINE MONITOR 
IS IT A LETTER "U"? 
GO TO USER ROUTINE 
IS IT A LETTER »W"? 
GO TO BASIC WARMSTART 
LOOP BACK IF NONE 



COLDSTART ROUTINE DUPLICATES LEVEL II ACTION TO 0075H. 
STACK POINTER NOT RESET HERE BECAUSE COLDSTART DOES IT. 



INTERRUPTS TURNED OFF 
CLEAR ACCUMULATOR 
BEGIN WRITE-PORT LOOP 
GET COMMUNICATION BLOCK 
GET COMMUNICATION AREA 
GET SIZE OF COMM. BLOCK 
BLOCK MOVE COMM. AREA 
A = A-1 (A=0 AT START) 
A = A-1 (FE, FC. FD...1 
CLEAR ALL EVEN PORTS 
GET 39 VAR. LOCATIONS 
BEGIN SETTING UP CHARS 
GET NEXT MEM POS'N 
LOOP THROUGH THEM ALL 
REST OF BASIC STARTUP 



ttttitttnMtttttttMtttttttttttttttttmtttnMttttttt 

USER ENTRY ROUTINE REQUIRES THAT A TWO-BYTE ADDRESS B 
STORED IN MEMORY AT 40BE/40BF (16526/16527). <=USR[0)> 

nttntrntitttnttttttttttttttttttttttttmuHttmit 



XOR 


A 


OUT 


(OFFHJ .A 


LD 


HL.06D2H 


LD 


DE.4000H 


LD 


BC.0036H 


LOIR 




DEC 


A 


DEO 


A 


JR 


NZ, CLEAR 


LD 


B.27H 


LD 


IDE) .A 


INC 


DE 


DJNZ 


L00P1 


JP 


007 5H 



POP 


HL 




; BEGIN TO CLEAR THE 


POP 


DE 




; STACK OF ALL 


POP 


BC 




; REGISTERS PUSHED 


POP 


AF 




; AT ENTRY POINT 


LD 


SP, 


(4EE2H) 


; GET ORIGINAL STACK PTR 


LO 


HL. 


(408EH) 


; GET USR(O) ENTRY POINT 


JP 


(HL) 


; AND JUMP TO IT 



WARM START ROUTINE RESTORES STACK BEFORE GOING TO BASIC 

mmntttututuututittttttttttttttftttHttttuttt 



RESTORE ALL REGISTERS 
PUSHED ON STACK 
WHEN MONITOR 
WAS ENTERED 
GET ORIGINAL STACK PTR 
GO TO BASIC WARMSTART 



POP 


HL 


POP 


DE 


POP 


BC 


POP 


AF 


LD 


SP,(42E2H) 


JP 


06CCH 



. Listing 6-2. Power-up monitor program. 
|g^_ Chapter 6 



How Interpreters Work 



The concept of computer languages is far too 
complex for a single section, a single chapter or 
even a single book. They run from easy, messy, 
but capable languages like BASIC through hard 
and messy languages like FORTRAN, to neat, 
structured, but obtuse languages like Pascal and 
LISP. In between are pseudo BASICs like 
BASEX, plus a whole range of compiled 
languages and hybrid self-definers like FORTH. 

All these languages have one thing in 
common: they must eventually be broken into 
subroutines which operate in the machine 
language of the host processor. Compiled 
languages are broken into these subroutines 
when the program is written, but the bulk of 
material installed in small computers is 
accessed most easily by means of interpreters - 
executing one statement at a time, during a 
program's run. 

How does a computer get to the information 
to be interpreted or compiled? Here's a short 
rundown of how an interpreter does its work; 
compilers are similar, but they won't be 
covered here. 

Once a program has been constructed (and the 
method varies from machine to machine) it is in 
place for the computer to evaluate and execute. 
The process that follows is consistent with most 
interpreters: 

Once a program has been constructed, and 
the method varies from machine to machine, it 
is in place for the computer to evaluate and 
execute. The process that follows is consistent 
with most interpreters: 

1. Upon an execution command, the 
interpreter identifies the start of the 
program. 

2. The first command from the program is 
obtained. The interpreter compares this 
command, byte for byte, against a table of 
legitimate commands. In some interpreters, 
the commands are stored as full words; in 
others, they are tokenized. When a valid 
entry is found in the command table, this 
stage of interpretation is complete. If a valid 
entry is not found, the routine is exited, 
usually via a loop which can be intercepted 
by extensions to the interpreter. 
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30BF 
3072 
3075 
3078 
307B 
307F 
30S0 
3Q81 
30B4 
3086 
3087 
308A 
3D8C 
308D 
3090 
3093 
3086 
3089 
309C 
309F 
30A2 
30A5 
30A8 
30AA 
30AB 
30AD 
30AE 
30B1 
30B4 
30BS 
3086 
30B7 
30B8 
30BB 
30BC 
30BD 
30BE 
30BF 
30C0 
30C1 
30C4 
30C5 
3QC8 
30C9 
30GC 
30CF 
3002 
30D3 
3004 



30D7 
30DA 
30DG 
30DE 
30E0 
30E3 
30E5 
30EB 
30EA 
30EC 
30EE 
30F0 
30F2 
30F4 
30FB 
30FB 
30FB 
30FE 
3101 
3103 
3104 
3106 
3108 
31 0A 
31 OB 
310E 
3110 
3113 
3116 



210632 

11C03C 

CD8F32 

11003D 

ED4BE242 

C5 

E1 

CD1731 

D0E5 

E1 

C01731 

FDE5 

E1 

CD1731 

2ADE42 

CD1731 

2ADC42 

CD1731 

2ADA42 

0D1731 

2AD842 

CD1731 

ED5F 

67 

EDS7 

6F 

CD1731 

11B03D 

08 

F5 

E1 

08 

C01731 

D9 

ES 

D6 

C5 

08 

E1 

CD1731 

E1 

CD1731 

E1 

CD1731 

11003F 

CD1731 

1C 

7E 

CD2431 



CD0331 

FE21 

2832 

FE2F 

CA6E31 

FE2A 

CA0C30 

FE30 

38EB 

FE67 

30E7 

FE3A 

3804 

FE61 

3BDF 

21043F 

11033F 

010300 

EDBO 

2B 

FE60 

3802 

0620 

77 

CD4331 

1BBC 

21063F 

CD4331 

E9 



01020 
01030 
01040 
01050 
01060 
01070 
D10B0 
01090 
01100 
01110 
01120 
01130 
01140 
01150 
01160 
01170 
01180 
01190 
01200 
01210 
01220 
01230 
01240 
01250 
01260 
01270 
01280 
01280 
01300 
01310 
01320 
01330 
01340 
01360 
01360 
01370 
01380 
01390 
01400 
01410 
01420 
01430 
01440 
01450 
01460 
01470 
01480 
01490 
01500 
01510 
01520 
01530 
01540 
01550 
01560 
01570 
015B0 
01590 
01600 
01610 
01620 
01630 
01640 
01650 
01660 
01670 
01680 
01690 
01700 
01710 
01720 
01730 
01740 
01750 
01760 
01770 
01780 
01790 
01 BOO 
01810 
01820 
01830 
01840 
01B50 
01B60 
01870 
01880 
01890 
01900 
01910 
01820 
01930 
01840 



**t*ttt*t*tttHM*tttittttm**tttttttttit*t*ittttttttt 

MACHINE LANGUAGE MONITOR IS SIMPLE, DISPLAYING REGISTER 
CONDITIONS AT ENTRY, AND ACCEPTING MEMORY CHANGES. ALL 
REGISTERS ARE RESTORED UPON EXIT FROM THIS ROUTINE. 

tttttttitttttttttttnntmtttttttttttttttttttiitMttt*; 

MONTOR 



LD 


HL.MSG02 


, GET REGISTER DISPLAY 


LD 


DE,3CCDH 


GET SCREEN POSITION 


CALL 


DISPLY 


, DISPLAY THE MESSAGE 


LD 


DE,3D00H 


, GET SCREEN POSITION 


LD 


BC,t42E2H) 


GET STACK POINTER POS'N 


PUSH 


BC 


GET VALUE READY TO XFER 


POP 


HL 


TRANSFER BYTES TO HL 


CALL 


WORDER 


CONVERT 6. DISPLAY BYTE 


PUSH 


IX 


GET IT READY TO USE 


POP 


HL 


AND DO IT WITH IT 


CALL 


WORDER 


CONVERT & DISPLAY BYTES 


PUSH 


IY 


GET IT READY TO USE 


POP 


HL 


AND DO IT WITH IT 


CALL 


WORDER 


CONVERT & DISPLAY IT 


LD 


HL,[42DEH) 


POINT TO AF STACK VALUE 


CALL 


WORDER 


CONVERT & DISPLAY BYTE 


LD 


HL,[42DCH) 


POINT TO BC STACK VALUE 


CALL 


WORDER 


CONVERT & DISPLAY BYTE 


LD 


HL.14EDAH) 


POINT TO DE STACK VALUE 


CALL 


WORDER 


CONVERT & DISPLAY BYTE 


LD 


HL,(4SDBH) 


POINT TO HL STACK VALUE 


CALL 


WORDER 


CONVERT & DISPLAY BYTE 


LD 


A,R 


GET R REGISTER INTO A 


LD 


H,A 


GIVE IT FOR CONVERSION 


LD 


A, I 


GET I REGISTER INTO A 


LD 


L,A 


GIVE IT FOR CONVERSION 


CALL 


WORDER 


CONVERT & DISPLAY BYTE 


LD 


DE,3D80H 


GET NEW VIDEO POSITION 


EX 


AF.AF 1 


TRANSFER OTHER VALUE 


PUSH 


AF 


READY TO XFER TO HL 


POP 


HL 


EFFECT TRANSFER TO HL 


EX 


AF.AF' 


RETURN ORIGINAL VALUE 


CALL 


WORDER 


CONVERT a DISPLAY BYTE 


EXX 




TRANSFER BC, DE, HL 


PUSH 


HL 


FIRST SLIP BC ON STACK, 


PUSH 


DE 


THEN PUSH DE THERE, 


PUSH 


BC 


AND THEN THE LAST ONE. 


EXX 




TRANSFER REGISTERS BACK 


POP 


HL 


GET VALUE ALL READY 


CALL 


WORDER 


CONVERT a DISPLAY BYTE 


POP 


HL 


GET DE VALUE READY 


CALL 


WORDER 


CONVERT & DISPLAY BYTE 


POP 


HL 


GET HL VALUE READY 


CALL 


WORDER 


CONVERT & DISPLAY BYTE 


LD 


DE.3F00H 


GET NEW SCREEN POS'N 


CALL 


WORDER 


CONVERT 6i DISPLAY BYTE 


INC 


E 


BUMP SCREEN POSITION 


LD 


A,(HL) 


GET VALUE FROM MEMORY 


CALL 


HEXASC 


AND DISPLAY IT IN ASCII 



CHECK 



**ttttt**tttttttttttt*tt*tttttttt*ttnttttttttm 

ADDRESS MOD ROUTINE GETS KEYBOARD VALUE & LOOPS BACK 

*tmttttttt*t*tt**WHtttttttitmtnttttttmttnt»tt 



ADDMOD CALL 
CP 
JR 
CP 
JP 
CP 
JP 
CP 
JR 
CP 
JR 
CP 
JR 
CP 
JR 

NUMBER LD 
LD 
LD 
LDIR 
DEC 
CP 
JR 
SUB 
LD 

CALL 
JR 
LD 

CALL 
JP 



ZIPBY 
NUM2 



INPUT 

■I' 

Z.EXEC 

'/' 

Z.DATMOD 

i*i 

Z.CLS 

'0' 

C, ADDMOD 

67H 

NC, ADDMOD 

i . i 

C, NUMBER 

61 H 

C, ADDMOD 

HL.3FD4H 

DE.3F03H 

BC3 

HL 

60H 

C, ZIPBY 

20H 

(HLl.A 

ASCHEX 

CHECK 

HL.3F06H 

ASCHEX 

(HL) 



GET VALUE FROM KEYBOARD 
TEST FIRST IF EXECUTE 
OUT IF EXECUTE COMMAND 
TEST SECOND IF DATA 
OUT IF DATA MOD COMMAND 
TEST THIRD IF RET MENU 
OUT TO MENU IF A STAR 
SEE IF <0 CHARACTER 
LOOP BACK IF <0 CHAR. 
SEE IF >F CHARACTER 
LOOP BACK IF >F CHAR. 
SEE IF <9 CHARACTER 
GO TO NUMBER ROUTINE 
SEE IF >A CHARACTER 
LOOP BACK IF <A S >9 
GET ADDRESS SCREEN POSN 
GET NEXT SCREEN POS'N 
GET THREE TOTAL POS'NS 
AND MOVE THEM OVER 
REPOSITION TO LAST CHAR 
COMPARE TO L.C. ALPHA 
IF NUMBERIC, THEN SKIP 
ELSE CONVERT TO U.CASE 
DISPLAY NEW CHARACTER 
CONVERT DISPLAY TO HL 
AND LOOP BACK FOR MORE 
POINT HL TO ADDRESS 
AND CONVERT TO HEX 
HL CONTAINS ADDRESS 



; t***t*tt*tntttttmtttttttttmtt<mmitttttMtftttttt 

; SUBROUTINE RESPONSIBLE FOR CONVERTING & DISPLAYING TWO- 
; BYTE WORDS DELIVERED TO IT IN THE HL REGISTER. 

Listing Continued . , , 



3. If the command is identified as a 
legitimate one, a subroutine is called which 
executes the command. That subroutine in 
turn may further examine the command line 
for operands and conditions, incrementing 
and decrementing pointers in its search for 
required, and valid, information. Further 
subroutines are entered as necessary to 
evaluate and put to use this additional 
information. In-memory variables and 
pointers are set up, modified, and accessed 
by all subroutines, usually from a master 
table which defines variable types and 
syntax conditions. Transcendental functions 
are also accessed via tables within the 
interpreter itself. Error checking is done at 
all points. 

4. When the execution of each subroutine is 
completed, it returns to the calling program. 
Eventually, all subroutines have returned to 
their upper level of subroutine 'nesting'. 
Then the execution routine finds itself 
re-entered, positioned at the next executable 
point in the program, where the execution 
process is repeated. 

5. The execution routine may, depending on 
the language, find itself repositioned in the 
program out of normal execution sequence. 
On the other hand, some languages have an 
inherent structure which disallows any 
repositioning, demanding an inviolable first 
to-last execution sequence. In these latter 
interpreters, repositioning will be interpreted 
as an error condition. 

6. If any information, commands, program 
order or program syntax is incorrect, an error 
handling routine is entered, usually by direct 
jump rather than subroutine call. Normally, 
this routine prepares and presents an error 
message. It returns the program from 
execution level, arbitrarily cancelling any 
nested execution subroutines by readjusting 
stack pointers and other variable information. 

This readjustment is necessary to avoid 
unsettling the user-interactive command- 
level routine, and causing the processor to 
lose its way in a complex of incomplete 
subroutines. 

7. Upon completion of all program 
statements, the program is returned from 
execution level to command level. Some 
interpreters allow commands to be entered, 
interpreted, and executed from a command 
buffer, without actually entering a program 
execution condition. 
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01950 ; tHltttflttittttitt*l***tttttttttHtltt*Mmmt*ttt*lt 
01960 ; 



3117 1C 


01970 WORDEH 


INC 


e ; 


BUMP DE REGISTER ALONG 


3118 1C 


01980 




INC 


E i 


SOME MORE BUMPING ... 


3113 1C 


01990 




INC 


E i 


... AND SOME MORE OF IT 


31 1A 7C 


02000 




LD 


A.H i 


GET FIRST BYTE OF IT 


31 1B CD2431 


02010 




CALL 


HEXASC ; 


CONVERT & DISPLAY BYTE 


311E 70 


02020 




LD 


A,L i 


GET SECOND BYTE OF IT 


311F CD2431 


02030 




CALL 


HEXASC ; 


CONVERT & DISPLAY BYTE 


3122 1C 


02040 




INC 


J= ; 


AND POSITION SCREEN 


3123 C9 


02050 
020B0 ; 




RET 


' 


AND BACK TO CALLER 




02070 i 


##### 


tttntt 


«#####»«#«#«« 


«#«#««««««««« 




02080 ; 


HEXADECIMAL TO ASCII CONVERSION 


FOR TWO-BYTE WORDS 




02090 ; 


ttwtt 


Mtttttt**ittt**ttttnt*nttt*in**t»*tmttttt*tt 




02100 ; 










3124 F5 


02110 HEXASC 


PUSH 


AF ; 


SAVE BYTE IN AF REG. 


3125 E6F0 


02120 




AND 


OFOH ; 


AND MASK OUT LOW NYBBLE 


3127 OF 


02130 




RRCA 




BEGIN ROTATING BIT ... 


3123 OF 


02140 




RRCA 




... IN ORDER TO TEST... 


3129 OF 


02150 




RRCA 




... THE LOW NYBBLE ... 


31 2A OF 


02160 




RRCA 




... ALL BY ITSELF. 


31 SB CD3931 


02170 




CALL 


HXAC 


BYTE RANGE EVALUATION 


31 2E 12 


02180 




LD 


IDE), A 


DISPLAY ON THE SCREEN 


312F 1C 


02190 




INC 


E 


AND MOVE TO NEXT POS'N 


3130 F1 


02200 




POP 


AF 


RESTORE ORIGINAL BYTE 


3131 E60F 


02210 




AND 


OFH 


AND MASK OUT HIGH BITS 


3133 CD3931 


02220 




CALL 


HXAC 


RANGE EVALUATION ROUT. 


3136 12 


02230 




LD 


IDE) ,A 


AND DISPLAY ON SCREEN 


3137 1C 


02240 




INC 


E 


MOVE TO NEXT VIDEO POSN 


313B C9 


02250 
02260 ; 




RET 




AND BACK TO CALLER 




02270 ; 


##«s 


tttmttttmtitttttttttttmttttmtiiittttttmt 




02280 : 


HEX-ASCII RANGE EVALUATION FOR 


TO 9 AND A TO F AREAS 




02290 ; 


itttmtmmtt*t*mMt*tntim*ttt**ittt»tt**t**ttt* 




02300 ; 












02310 ; 










3139 FEOA 


02320 HXAC 


CP 


OAH 


CHECK AGAINST 10 DEC. 


313B 3003 


02330 




JR 


NC, NEXTX 


IF >10 THEN ALPHA CHAR 


3130 C630 


02340 




ADD 


A.3DH 


ELSE NUMERIC - CONVERT 


313F C9 


02350 




RET 




, AND BACK TO CALLER 


3140 C637 


02360 NEXTX 


ADD 


A.37H 


; ALPHABETIC - CONVERT 


3142 C9 


02370 
02380 




RET 




; AND BACK TO CALLER 




02390 


ttttittntt 


ntt*itt**»tM***t*t*tt*H*t**t*HR****ftttt 




02400 


ASCII TO HEXADECIMAL CONVERSION FOR TWO-BYTE WORDS 




02410 


#### 


mm* 


mtmtmmi*tmttmmim***t**iii*tt 




02420 












02430 










3143 CD6331 


02440 ASCHEX 


CALL 


ACHX 


; RANGE EVALUATION ROUT. 


3146 4F 


02450 




LD 


C,A 


; SAVE PART OF CONVERSION 


3147 2B 


02460 




DEC 


HL 


; AND GET NEXT BYTE 


31 4B CD5B31 


02470 




CALL 


LLLLS 


; EXECUTE LEFT ROTATES 


314B B1 


024B0 




ADD 


A.C 


i AND ADD TO MAKE BYTE 


314C 4F 


02490 




LD 


C,A 


; SAVE IT BACK IN C REG. 


31 4D 2B 


02500 




DEC 


HL 


; AND MOVE TO NEXT BYTE 


31 4E CD6331 


02510 AX2 


CALL 


ACHX 


; DO RANGE EVALUATION 


3151 47 


02520 




LD 


B,A 


; AND SAVE IT IN B REG. 


3152 2B 


02530 




DEC 


HL 


; GET FINAL BYTE READY 


3153 CD5B31 


02540 




CALL 


LLLLS 


; AND EXECUTE LEFT ROTATE 


3156 80 


02550 




ADD 


A,B 


i CREATE COMPLETE BYTE 


3157 47 


02560 




LD 


B,A 


; AND SAVE IT IN B REG. 


3158 C5 


02570 




PUSH 


BC 


; GET 2 BYTES TO XFER 


3159 E1 


02580 




POP 


HL 


; TRANSFER TO HL REGISTER 


315A C9 


02590 




RET 




i AND BACK TO CALLER 


31 5B CD6331 


02600 


LLLLS 


CALL 


ACHX 


; EVALUATE RANGE OF CHAR 


31 5E 07 


02610 




RLCA 




i BEGIN LEFT ROTATES ... 


31 5F 07 


02620 




RLCA 




: ... WHICH WILL POS'N... 


3160 07 


02630 




RLCA 




; ... BYTE READY FOR ... 


3161 07 


02640 




RLCA 




; ... CONVERSION. 


3162 C9 


02650 




RET 




; AND GO BACK TO CALLER 


3163 7E 


02660 


ACHX 


LD 


A,(HLJ 


; GET BYTE FROM SCREEN 


3164 FE40 


02670 




CP 


40H 


; CHECK AGAINST ALPHA 


3166 3003 


02680 




JR 


NC, NEXTZ 


; IF NUMERIC THEN JUMP 


3168 0630 


0269B 




SUB 


SDH 


; ELSE NUMBER TO HEX 


31 6A C9 


02700 




RET 




; AND BACK TO CALLER 


31 6B D637 


02710 


NEXTZ 


SUB 


37H 


; THEN IT'S ALPHA TO HEX 


316D C9 


0272Q 
02730 




RET 




' AND BACK TO CALLER 




02740 


; tttttfflmtMtttitimtnttttttttttttttttnttntmttt 




02750 


; ROUTINE TO 


ACCEPT DATA FOR INPUT TO DISPLAYED MEMORY 




02760 


i LOCATIONS, 


WITH EXIT TO MENU 


JPDATE OR MEMORY INCREMENT 




02770 


; ttttttttt'ttttttttmtttttttti 


ittttttttttttnttmtttttt 




02780 


• 








31 6E CDC331 


027 SO 


DATMOD CALL 


INPUT 


; GET CHAR. FROM KEYBRD. 


3171 FE2E 


02B00 




CP 


1 .' 


; IS IT A PERIOD? 


3173 CABD31 


02B10 




JP 


Z.ADEXIT 


; IF SO, EXIT TO ADDR MOD 


3176 FEOD 


02820 




CP 


ODH 


; IS IT A CARRIAGE RET? 


3178 282F 


02830 




JR 


Z.NEXTD 


; IF SO, GO TO NEXT DATA 


31 7A FE30 


02840 




CP 


'0' 


; BEGIN TESTING FOR RANGE 


317C 38F0 


02850 




JR 


C, DATMOD 


; BACK IF <0 CHARACTER 


317E FE67 


02B60 




CP 


67H 


i CHECK AGAINST LC ALPHA 


31 BO 30EC 


02870 




JR 


NC, DATMOD 


; IF >F THEN GO BACK 
Listing Continued . 
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It was natural that Radio Shack would choose 
an inexpensive storage medium, cassettes, to 
accompany their low cost microcomputer. 
Because ordinary cassette players are audio 
devices, the tape saving and loading routines 
were designed to be slow but sure. With care, the 
CTR series of recorders can be as reliable as any 
other storage system designed for the TRS-80. 

The weakness of the tape process comes from 
the obvious mismatching of an audio device, of 
very limited precision, with a digital device of 
unyielding high-precision. Portable cassette 
recorders are intended to reproduce audio signals 
with a reasonable level of fidelity. What 
constitutes a reasonable level of fidelity is 
disputable, and only a person with a true tin ear 
would not be able to pick out a portable player, 
from amongst a group of high fidelity tape decks. 

But even with this 'reasonable' fidelity, much 
of what we recognize as harmonies and 
instrumentation is perceptible only because we 
already have an acculturated comprehension of 
sound; and this directly influences what we 
believe we are hearing. Our minds, in 
conjunction with our ears - average, fill in, 
smooth over and forgive minuscule failings. We 
have internal mechanisms which remember our 
experiences. 

The cassette load/save system consists of 
seven major elements: 



1. Serialization. 

The individual bytes of computer data are 
converted into a stream of individual bits. 
This is a completely digital process, and the 
timing is provided by the computer. 

2, Audio Processing. 

The signal is converted into a 'digital audio' 
wave for recording on tape decks of unknown 
polarity. In other words, a digital, one to zero, 
signal is converted to an audio, one to minus 
one to zero, signal. In this way, an 'upside 
down' signal looks the same to a computer as 
the original. 



3. Recording. 

The signal goes through the tape recorder's 
electronics, and is recorded on a thin strip of 
magnetic tape. The audio electronics round 
the wave's edge, and the limitations of the tape 
contribute noise to the signal. 
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31 82 FE3A 


02BB0 




CP 


':' 


i TEST FOR NUMERIC >9 


31B4 3804 


02890 




JR 


C, INDATA 


i IF <9 THEN GET DATA 


31 86 FEB1 


02900 




CP 


61H 


; TEST FOR ALPHA <A 


3188 3BE4 


02910 




JR 


C.DATMOD 


; IF <A THEN GO BACK 


31 8A 210A3F 


02920 


INDATA 


LD 


HL.3F0AH 


; READY THE SCREEN PTR. 


318D F5 


02930 




PUSH 


AF 


; SAVE VALUE FROM KEYBRD 


31BE 7E 


02940 




LD 


A,(HL) 


; GET LOWER ASCII NYBBLE 


318F 32093F 


02950 




LO 


(3F09H) ,A 


; AND PUT IN HIGH POS'N 


3192 F1 


02960 




POP 


AF 


; RESTORE VALUE FROM KBD 


3193 FE6D 


02970 




CP 


60H 


; CHECK AGAINST LC ALPHA 


319S 3802 


02980 




JR 


C,ZIPZY 


i IF LC, THEN SKIP PAST 


3197 D620 


02990 




SUB 


20H 


; ELSE CONVERT TO U.C. 


3199 77 


03000 2IPZY 


LD 


[HL] ,A 


; AND DISPLAY ON SCREEN 


319A CD4E31 


03010 




CALL 


AX2 


; SINGLE BYTE CONVERSION 


319D 7C 


03020 




LD 


A,H 


; SAVE ONE BYTE IN A REG. 


319E F5 


03030 




PUSH 


AF 


; SAVE THAT NOW ON STACK 


319F 21063F 


03040 




LD 


HL,3FQ6H 


; POINT HL TD SCREEN POSN 


31A2 CD4331 


03050 




CALL 


ASCHEX 


; EVALUATE ADDRESS THERE 


31AS F1 


03060 




POP 


AF 


RESTORE VALUE TO SHOW 


31A6 77 


03070 




LD 


(HLJ ,A 


i AND PUT ON THE SCREEN 


31A7 1807 


03080 




JR 


EXIT1 


NOW GO OUT AND STORE 


31A9 21B63F 


03090 NEXTD 


LD 


HL.3F06H 


, POINT HL TO SCREEN POSN 


31AC CD4331 


03100 




CALL 


ASCHEX 


CONVERT ADDRESS TO HEX 


31AF 23 


03110 




INC 


HL 


MOVE OVER TD NEXT POSN 


31 BO 11003F 


03120 EXIT1 


LD 


DE,3FO0H 


POINT DE ADDR. DISPLAY 


31 B3 CD1731 


03130 




CALL 


WORDER 


AND CONVERT/DISPLAY IT 


31BB 1C 


03140 




INC 


p 


GO TO NEXT SCREEN POSN 


31 B7 7E 


03150 




LD 


A,(HL] 


GET VALUE FROM MEMORY 


31 B8 CD2431 


03160 




CALL 


HEXASC 


AND CONVERT FOR DISPLAY 


31 BB 18B1 


03170 




JR 


DATMOD 


AND BACK FOR SOME MORE 


31 BD 210B3F 


03180 ADEXIT 


LD 


HL,3F06H 


POINT TO PRESENT ADDR. 


31C0 C30B31 


03190 
03200 




JP 


NUH2 


AND BACK TD UPDATE MENU 




03210 


«#««««««#«««#«###« 


ttttttitttttMtttMtttttt 




03220 


COMPLETE KEYBOAFID ROUTINE BELO 


K MAY BE CALLED BY NOT 




03230 


ONLY 


THE MONITOR ROUTINES, BUT 


ANY ROUTINES NEEDING AN 




03240 


UPPER/LOWER 


CASE, AUTOREPEAT, 


3EEP DRIVER. FOR FURTHER 




03250 


DESCRIPTION 


SEE SUPPLEMENT TO 


CHAPTER ON KEYBOARD I/O 




03260 


ttttummttmtmttmmtmtmmmttmmtm 




03270 










31 C3 213640 


032B0 ] 


NPUT 


LD 


HL.4036H 


SAME AS LII BUFFER 


31C6 010138 


03290 




LD 


BC.3BD1H 


FIRST KEYBOARD ROW 


31C9 1600 


03300 




LD 


0,0 


COUNTER FOR COLUMNS 


31CB OA 


03310 t 


EYPRS 


LD 


A,(BC) 


RETRIEVE ROW CONTENTS 


31CC 5F 


03320 




LD 


E,A 


SAVE IT TEMPORARILY 


31 CD A3 


03330 




AND 


E 


SET FLAGS FOR TESTING 


31CE 201B 


03340 




JR 


NZ, STROKE 


NOT ZERO IF KEY PRESSED 


31 DO 77 


03350 




LD 


(HLJ, A 


SAVE CURRENT VALUE 


3101 14 


03360 F 


ECHEK 


INC 


D 


INCREMENT ROW COUNTER 


31D2 2C 


03370 




INC 


L 


INCREMENT STORAGE ADDR. 


3103 CB01 


033 BO 




RLC 


C 


GET NEXT KEYBOARD COL. 


3105 73 


03390 




LD 


A,C 


GET VALUE INTO ACCUM. 


31D6 0680 


03400 




SUB 


BOH 


LAST ROW IS 3880 HEX 


31 OB 20Ft 


03410 




JR 


NZ,KEYPRS 


NEXT CHECK IF NOT DONE 


31DA 06D7 


03420 




LD 


B,7 


COUNTER DF KEYBRD ROWS 


31DC 2D 


03430 C 


LHHEH 


DEC 


L 


START COUNTING BACKWARD 


31 DO 86 


03440 




ADD 


A,(HL) 


AND ADD IT UP IN ACCUM. 


31 DE 10FC 


03450 




DJNZ 


CLRMEM 


AND DO IT FOR 7 ROWS 


31 EO A7 


03460 




AND 


A 


TEST FOR ANY KEY DOWN 


31 E1 3E00 


03470 




LD 


A,0 


A=0, FLAGS ARE INTACT 


31 E3 CO 


03480 




RET 


NZ 


BACK IF KEYS IN USE 


31 E4 321A40 


03490 




LD 


(KPLACE),A 


ELSE DELAY GETS RESET 


31 E7 C9 


03500 




RET 




AND GO BACK ANYWAY 


31 EB A6 


03510 E 


TROKE 


AND 


(HL) 


CHECK KEYSTROKE STORAGE 


31 E9 281 B 


03520 




JR 


Z, FOUND 


NEW KEY IF NOT SAME ONE 


31 EB 3A1A40 


03530 




LD 


A,(KPLACE) 


NEW CHECK SPECIAL STORE 


31 EE 3C 


03540 




INC 


A 


LET STORE = STORE + 1 


31 EF 321A40 


03550 




LD 


(KPLACE),A 


AND PUT IN BACK THERE 


31F2 FEFF 


03560 




CP 


OFFH 


CHECK IF IT IS AT END 


31F4 2BD8 


03570 




JR 


Z.DECA ; 


IF SO, THEN HOLD THERE 


31F6 C5 


03580 




PUSH 


BC ; 


SAVE ROW COUNTER REG. 


31F7 OBFF 


03590 




LD 


B.OFFH , 


GET DELAY VALUE INTO B 


31F9 10FE 


03600 T 


MWSTE 


DJNZ 


TMWSTE ; 


AND DELAY JUST A BIT 


31FB 01 


03610 




POP 


BC ; 


RESTORE ROW COUNTER 


31FC 1BD3 


03620 




JR 


RECHEK ; 


AND BACK TD CHECK NEXT 


31FE 3D 


03630 D 


ECA 


DEC 


A ; 


LET A = A - 1 (STORE) 


31FF 321A4Q 


03640 




LD 


(KPLACE).A ; 


AND PUT IT IN STORAGE 


3202 7B 


03650 




LD 


A,E ; 


GET KEYBOARD BYTE BACK 


3203 73 


03660 F 


OUND 


LD 


(HL),E j 


STORE IT IS STROKE AREA 


3204 7A 


03670 




LD 


A,D ; 


GET ROW COUNTER FROM D 


3205 07 


03680 




RLCA 




AND BEGIN PROCESS OF... 


3206 07 


03690 




RLCA 




...CONVERTING IT... 


3207 07 


03700 




RLCA 




...TO. AN OFFSET VALUE 


3208 57 


03710 




LD 


D,A ; 


AND PUT IT BACK IN D 


3209 0E01 


03720 




LD 


C,1 ; 


GET NUMBER ONE READY 


320B 79 


03730 B 


ACKUP 


LD 


A,C ; 


ACCUM. HAS C FOR MASK 


320C A3 


03740 




AND 


E j 


TEST IF C = KEYSTROKE 


3 200 2005 


03750 




JR 


NZ, AROUND ; 


IF NOT, THEN GO AROUND 


320F 14 


03760 




INC 


D ; 


ELSE = ROW + COLUMN 


3210 CB01 


03770 




RLC 


C j 


C SET TO NEXT COLUMN 


3212 18F7 


03780 




JR 


BACKUP ; 


GO BACK AND TEST AGAIN 


3214 3A8D38 


03790 A 


ROUND 


LD 


A,(3B80H) ; 


GET SHIFT ROW FOR TEST 


3217 47 


03800 




LD 


B,A ; 


AND SAVE IT IN B REG. 



4. Storage. 

The tape sits on the shelf, affected by 
temperature and humidity, where its oxide 
coating may 'creep'. The tape may stretch or 
buckle or warp, and its upper and lower edges 
may become slightly feathered. 

5. Playback. 

The recorded signal, including warps, 
dropouts, feathering, creep and noise, is fed to 
the playback electronics. This audio circuit 
contributes further noise, providing a purely 
low grade audio signal to the computer. 

6. Digital Processing. 

The signal is received, its top and bottom 
edges are squared, and it is returned to the one 
to zero digital state. The timing is provided by 
the recorded tape in cooperation with timing 
loops provided by the computer. 

7. De-Serialization. 

A completed group of bits is assembled into an 
8 bit byte for use by the CPU in determining 
synchronization, type of program, loading 
location, etc. 



An oscilloscope representation of a digital 
signal being generated during the CSAVE 
routine is shown below. The signal changes from 
one to zero very crisply, spending only a few 
nanoseconds (not visible at all on the photo) in 
the transition area between one and zero. This 
true digital signal is measured just before the 
audio processing section sent to the cassette. 
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The audio processing is actually no more than 
a digital signal whose polarity is reversed. Two 
outputs of a latch are tied together, and as one 
goes high, the other is forced low. Between 
pulses, the signal floats to the middle. This is 
done by data bits and 1 of Z59, which are 
alternately switched by the CPU during CSAVE. 
The digital signal as it leaves the cassette port is 
shown in the second photograph. 

The sharp edges of the signal have been ever so 
slightly blurred, partly due to the capacitance 



The Custom TRS-80 



157 



The CLOAD Problem 



Continued Listing 



3218 7A 
321 S C640 
321 B FE6D 
321D 3016 
321F 57 
3220 3A403B 
3223 EB10 
3225 200S 

3227 7A 

3228 CBOB 
322A 383D 
322C CB20 
322E 1838 

3230 7A-" 

3231 D640 
3233 1834 
3235 DB70 
3237 3010 

3239 C640 
323B FE3C 
323D 3B02 
323F EE10 
3241 CBOB 
3243 3024 
3245 EE10 
3247 1820 

3249 07 
324A CBOB 

3240 3000 
324E 215832 

3251 4F 

3252 0600 

3254 08 

3255 7E 

3256 1811 
325B 3C-" 
3259 ODOD 
325B 1F1F 

3250 0101 
325F 5B1B 
32B1 0A00 
3263 0818 
3265 091-9 
32B7 2020 
3289 57 
326A 018001 
326D OB 
326E 78 
326F B1 
3270 20FB 

3272 7A 

3273 F5 

3274 0640 
3276 3A3D40 
3279 E6FD 
327B 67 
327C F602 
327E 6F 
327F 7D 
32B0 D3FF 

3282 7C 

3283 D3FF 

3285 C5 

3286 0640 
3288 10FE 
328A C1 
32BB 10F2 
32BD F1 
32BE C9 



32BF 7E 
32B0 A7 

3291 C8 

3292 12 
3283 23 

3294 13 

3295 1BFB 



3297 3C 
32BB 3C 
32D4 8F 

3205 00 

3206 5A 



03810 

03820 

03830 

03840 

03850 

03860 

03870 

03BB0 

03880 

03800 

03910 

03920 

03830 

03940 CNTROL 

03950 

03960 

03870 JUMP1 

03880 

03980 

04000 

04010 

04020 

04030 JUHP3 

04040 

04050 

04060 

04070 JUHP2 

04080 

04090 

04100 JUMP4 

04110 

04120 

04130 

04140 

04150 

041 BO 

04170 TABLET 

041 BO 

04180 

04200 

04210 

04220 

04230 

04240 

04250 GOAWAY 

04260 

04270 DELAYS 

042B0 

04290 

04300 

04310 

04320 

04330 

04340 

04350 

04360 

04370 

04380 

04380 BEEPER 

04400 

04410 

04420 

04430 

04440 

04450 FREQCY 

04460 

04470 

04480 

04490 

04500 

04510 

04520 

04530 

04540 ; 

04550 DISPLY 

04560 

04570 

04580 

04580 

04600 

04610 

04620 

04B30 

04640 

04650 

04660 

04670 

04680 

04690 HSG01 

04700 

04710 

04720 

04730 HSGD2 



LD 

ADD 

CP 

JR 

LD 

LD 

AND 

JR 

LD 

RRC 

JR 

ADD 

JR 

LD 

SUB 

JR 

SUB 

JR 

ADD 

CP 

JR 

XOR 

RRC 

JR 

XOR 

JR 

RLCA 

RRC 

JR 

LD 

LD 
LD 

ADD 
LD 

JR 

INC 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

DEFW 

LD 

LD 

DEC 

LD 

OR 

JR 

LD 

PUSH 

LD 

LD 

AND 

LD 

OR 

LD 

LD 

OUT 

LD 

OUT 

PUSH 

LD 

DJNZ 

POP 

DJNZ 

POP 

RET 



A,D 

A.40H 

60H 

NC.JUMP1 

D,A 

A,(3840H) 

10H 

NZ, CNTROL 

A,D 

B 

C, GOAWAY 

A.20H 

60AWAY 

A,D 

40H 

BOA WAY 

70H 

NC.JUMP2 

A.40H 

3CH 

C, JUMPS 

10H 

B 

NC GGAnAY 

10H 

GOAWAY 



NC.JUMP4 

HL, TABLET 

C,A 

B,0 

HL.BC 

A,(HL) 

GOAWAY 

A 

ODODH 

1F1FH 

0101H 

1B5BH 

OOOAH 

1B08H 

1909H 

2020H 

D,A 

BC,180H 

BC 

A,B 

C 

NZ, DELAYS 

A,D 

AF 

B.40H 

A,(403DH) 

OFDH 

H.A 

2 

L,A 

A,L 

(OFFH) ,A 

A,H 

(OFFH) ,A 

BC 

B.40H 

FREOCY 

BC 

BEEPER 

AF 



GET ROW COUNTER BACK 
AND CONVERT TO ASCII 
IS IT UP/LW/GRAFIX/CTRL 
GO OUT IF GRAPHICS 
SAVE PARTLY CONVERTED 
GET VALUE FOUND 7TH ROW 
CHECK IF DOWN ARROW 
IF SO, PRODUCE CONTROL 
ELSE GET VALUE BACK 
B BUMPS INTO CARRY FLAG 
IF CARRY, THEN SHIFT 
IF NOT THEN LOWER CASE 
AND GET OUT OF ROUTINE 
IF CONTROL CODE, GET IT 
GET RID OF ASCII MASK 
AND GET OUT OF ROUTINE 
THE BALANCE OF THE 
ROUTINE BELOW UP TO 
THE BEEP SECTION IS 
VIRTUALLY IDENTICAL 
TO THE KEYBOARD 
DETERMINATION SUB- 
ROUTINE FOUND IN 
ROM. THIS ENTIRE 
ROUTINE IS REPEATED 
BECAUSE IT CAN 
SERVE AS AN EXACT 
REPLACEMENT FOR 
THE LEVEL II BASIC 
ROUTINES WHEN UF) 
THE ROMS HAVE BEEN 
REMOVED, REPLACED, 
DISABLED, ETC. 
SEE KEYBOARD ROUTINE 
RUNDOWN ELSEWHERE 

IN THIS BOOK 

CARR. RET. / CARR. RET. 
CLEAR SCRN / CLEAR SCRN 
BREAK KEY / BREAK KEY 
EDIT ESCAPE / UP ARROW 
NO CHANGE / LINEFEED 
BACKSP. LINE / BACKSP. 
32-CHAR MODE / HOR TAB 
SPACE / SPACE 
SAVE VALUE IN REG. 
DEBOUNCE VALUE AND 
IMPLEMENTED AT THIS 
POINT FOR ACTUAL 
KEYBOARD SCAN WHEN 
CHARACTERS ARE 
GET STOHED VALUE BACK 
SAVE ACCUM. & FLAGS 
GET BEEP LENGTH VALUE 
GET STATUS OF SCREEN 
MASK SCREEN CHANGE 
STORE MSB IN H REG. 
SET BIT 1 TO BE ON 
STORE ALT. MSB IN L REG 
GET ALT. MSB TO OUTPUT 
AND OUTPUT RISING WAVE 
GET NORMAL MSB CHAR. 
AND OUTPUT FALLING (HAVE 
SAVE NOTE LENGTH VALUE 
GET FREQUENCY DELAY 
AND WAIT A LITTLE WHILE 
NOW RESTORE LENGTH VAL. 
AND GO BACK THAT LENGTH 
RESTORE ORIGINAL CHAR. 
AND BACK TO CALLER 



spPii^piiiii 



ttttttttttttmtttttttttttmttt*t*ttttttmt»t*m*ttt 

ROUTINE BELOW TAKES SIMPLE MESSAGES AND DISPLAYS THEM 



LD 

AND 

RET 

LD 

INC 

INC 

JR 



A.IHL) 

A 

Z 

IDE), A 

HL 

DE 

DISPLY 



SET FIRST MSG CHARACTER 
TEST IF OR CHARACTER 
BACK TO CALLING ROUTINE 
DISPLAY THE CHARACTER 
GET NEXT MSG CHARACTER 
GET NEXT DISPLAY POS'N 
AND TEST NEXT CHARACTER 



iittttmtttttMttMttttttttttttttUtMMMMtmtttttt 
MESSAGES FOR DISPLAY FOLLOW. IN A STRIPPED SOFTWARE 
MONITOR CONFIGURATION, THESE MESSAGES MAY BE ELIMINATED 
AND DISPLAY PARAMETERS CHANGED ELSEWHERE IN THE LISTING 

ttttttttttmmtttmmitttttnnttttttttttmtttttH 



DEFM '<O0LDSTART, <D>ISKBOOT, <M>ONITOR, 

DEFM '<U>SERJUMP, <W>ARMSTART? > 

DEFB 8FH 

DEFB 00 

DEFM >ZBO REGISTERS AT MONITOR ENTRY: ' 




introduced by the cables and tape input. This is 
the first (and least significant) step in the 
extensive route of signal degradation. 



32F6 20 
3316 53 
3336 42 
33 56 41 
3376 4E 
3396 41 
33 BB 20 
3306 55 
33F6 53 
3416 45 
3436 28 
3456 4F 
3476 54 
3496 OD 
3497 

0000 



04740 

04750 

047B0 
04770 
04780 
04790 
04800 
04810 
04820 
04830 
04840 
04850 
04860 
04870 
04880 
04880 
04900 



OEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
DEFB 
XXXXXX EOU 

END 



t 



■SP= IX= IY= AF= ' 
'BC= DE= HL= RI= ' 
'ALTERNATE REGISTERS AT MONITOR E' 
'NTHY [NOT USED IN LEV II BASIC):' 

'AF= BC= DE= HL= ' 
, i 

'USE PERIOD I.) TO ENTER AN ADDRE' 
'SS, SLASH [/! TO ENTER DATA. TO" 
'EXIT TO MONITOR MENU, TYPE STAR • 
'(»), TO EXECUTE AT ADDRESS SHOWN' 
'ON SCREEN, TYPE EXCLAMATION POIN' 
■T 111 ' 

00 
S 



ACHX 3163 02660 
ADDMOD 30D7 01 620 
ADEXIT 31 BD 03180 
AROUND 3214 03780 
ASCHEX 3143 02440 
AX2 31 4E 02510 
BACKUP 3208 03730 
BEEPER 327F 04330 
CHECK 30CC 01520 
CLEAR 303E 00640 
CLRMEM 31DC 03430 
CLS 300C 0031 D 
CNTROL 3230 03940 
COLD 303C 00620 
DATMOD 31 6E 02790 
DECA 31 FE 03630 
DELAYS 326D 04270 
DISPLY 328F 04550 
EXEC 3110 01880 
EXIT1 31 BO 03120 
FOUND 3203 03660 
FREOCY 3288 04450 
GOAWAY 3269 04250 
HEXASC 3124 02110 
HXAC 3139 02320 
INDATA 31 8A 02820 
INPUT 31 C3 032B0 
3235 03970 
3249 04070 
3241 04030 
324E 04100 
KEYPRS 31 CB 03310 
KPLACE 401A 00160 
LLLLS 31 5B 02600 
L00P1 3051 00730 
MENU 3022 00440 
MQNTOR 306F 01DBQ 

MSG01 3297 04690 
32D6 04730 
31A9 03090 
3140 02360 
31 EB 02710 
3108 018B0 
NUMBER 30FB 01770 
RECHEK 31 D1 03360 
STROKE 31 E8 03510 
TABLET 3259 04170 
THWSTE 31 F9 03600 
USER 3058 00830 
WARM 3064 00950 
WORDER 3117 01970 

XXXXXX 3497 04880 
ZIPBY 31 OA 01850 
ZIPZY 3199 03000 



JUMP1 
JUMP2 
JUMP3 
JUMP4 



MSG02 
NEXTD 
NEXTX 
NEXTZ 
NUM2 



02440 02510 02600 

01700 01720 01760 

02810 

03750 

01860 01890 03050 03100 

03010 

03780 

04470 

01B70 

00710 

03450 

01B80 

03880 

00460 

01660 02850 02870 02910 03170 

03570 

04300 

00430 01100 04610 

01640 

03080 

03520 

04450 

03810 03930 03960 04040 04060 04150 

01560 02010 02030 P3160 

02170 02220 

02890 

00440 01620 02790 

03840 

03980 

04010 

04080 

03410 

03490 03530 03550 03640 

02470 02540 

00750 

00550 

ODSDO 

D0410 

01080 

02830 

02330 

02E80 

03190 

01740 

03620 

03340 

04100 

03600 

00520 

00540 

01150 01180 01210 01230 01250 01270 01290 

01340 01400 01470 01480 01510 01530 03130 

01830 
02980 
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The worst signal abuse takes place during the 
taping process. The reasonably digital signal is 
recorded with the poor electronics of a portable 
tape recorder, and the sharp-edged waves are 
rounded off by the natural limitations of the tape 
itself; examine Photo 6-4. Also visible in the photo 
are residual noise (tape hiss) and the high-frequency 
recording bias signal. 

There is also an unexpected interreaction 
between the computer's output wiring and some 
tape recorders that produces a low-pitched hum, 
called a ground loop. The good data signal can 
ride on this ground-loop hum to result in sensitive 
volume settings — too high or low a volume during 
playback will cause the top or bottom of the digital 
waveform to travel out of the range of the digital 
processing. 

This digital processing redeems quite a bit of the 
audio signal, turning it back into a usable digital 
waveform much of the time. Photo 6-5 shows the 
results of the reshaping process; it's a fairly good 
signal that the CPU finally receives and must 
interpret as data. 

Now the names and descriptions of the seven 
CLOAD culprits: 



1. Head misalignment. This is the main 
cause of bad loads, because misalignment 
severely cuts the essential high frequencies. 
The CTR-80 already has a provision for adjust- 
rwOOing the playback head. If you have a CTR- 
41 (or other recorder), drill a hole directly over 
the playback head adjustment screw (under 

1. Head misalignment. This is the main cause 
of bad loads, because misalignment severely 
cuts the essential high frequencies. The CTR- 
80 already has a provision for adjusting the 
playback head. IfyouhaveaCTR-41 (or other 
recorder), drillahole directly over the playback 
head adjustment screw (under the letters ERY 
in 'battery' on the CTR-41 face plate), and 
adjust with a small Phillips screwdriver. 

2. Speed variations. This one is not obvious, 
but note that a five percent variation in recorder 
speed can cause a bad load, especially with 
long BASIC lines during CLOAD. 

3. Bad tape. There is no reason to use low- 
grade tape, just as there is no reason to buy the 
best audio tape. Get a good commercial grade, 
and standardize with it. 

4. Dirty head. Clarity and volume are cut 
down when the head is dirty. Clean it and all 
parts that contact the tape with isopropyl 
alcohol. 



5. Starting too soon. The beginning of most 
tape — especially leaderless tape — is often 
slightly crumpled, and data can be lost right at 
the start. Count off ten seconds. 

6. Magnetized head. Those who depend on 
cassettes will use the machine often, and the 
head will build up residual magnetism. Obtain a 
cassette demagnetizer (degausser) and use it 
often. 

7. Software. Early Level E BASIC ROMs 
have problems because the timing loops were 
not written ideally for low-grade audio use. 
These can be upgraded with new ROMs or the 
Radio Shack XRX cassette modification. 
Note, however, that removal of the XRX 
modification is necessary for use with high/low 
speed hardware modifications (except the 
Archbold 1981-82 kit). 




Photo 6-4. Rounded- off digital signal with tape hiss. 




Photo t>-0. Keshaped wave that the CPU finally sees. 
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Controlling the World 




Controlling the World 

The world is out there, waiting to be controlled 
by your TRS-80. Really. Most of the 
partly-mechanized daily routine that you find 
yourself doing by hand might be connected to the 
'80. Not that it should be, mind you, but it could 
be. You could successfully operate a clothes 
washer and drier, a dishwasher, an automatic 
furnace, an air conditioner, or many other 
electromechanical devices; turn lights, 
televisions, and radios on and off, as well as 
replace your ordinary wake-up alarm; dial the 
phone, or answer it in a synthetic voice; even act 
as a digital burglar alarm. But would you really 
want to? 

Admittedly, microprocessors are making their 
way into more and more appliances, including 
such diverse items as automobile engines and 
electric razors. But remember that the TRS-80 
is a spectacular general-purpose device; 
although it might do all sorts of control work, it's 
best suited to applications calling for a large 
library of different electronic tasks, most with 
crucial human interaction. Aside from machine 
- oriented tasks like word processing, 
calculating, and printing, then, these 
applications include (generally speaking) 
measurement, signalling, and cloning. 

Measurement involves the evaluation of a 
real-world occurrence in real time: checking 
temperature, counting events, comparing 
relative amounts of light or voltage or sound. 
Some of these measurements, like counting 



events, are inherently digital - an event (say, a 
person walking through a door) either is taking 
place or it isn't. A door is closed or it's open. And 
so on. Other measurements are relative or 
quantitative, consisting of small increments or 
continuous change, such as the pressure, the rate 
of flow, or the quantity of water in a pipe. 

Signalling is somewhat the opposite of 
measurement: a user is informed when some 
activity has been completed, or when a particular 
condition in the environment has been reached - 
including such things as the completion of a 
mailing list sort or someone breaking and 
entering. 

Cloning is a rather odd phrase, but it's what I 
would like to call the computer's ability to create 
precise duplicates of some target object or 
activity. If that sounds a bit too philosophical, 
then think of it this way: the computer is fast, 
which means if it is given a task, it can complete 
it quickly. The computer is capable of 
calculating the parameters of its task with 
enormous accuracy. And finally, the computer 
works in minute, definable, and identical 
increments. Simply stated, we can command a 
computer to do work which, barring glitches and 
bugs, will be identical every time. 

This last concept is the reason 
microprocessors have become the favored design 
tools for machining, measurement, and even the 
creation of music. Jigs wear out, so that 
tolerances change; but computer programs can 
be self-correcting. Measuring devices can go out 
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of alignment: again, computers can be 
programmed to cross-check and correct these 
errors. And finally, where electronic design has 
been sloppy as a result of inaccuracies in the 
electronic parts themselves (such as in 
synthesized music), computers can provide the 
advantages of precise replication where it was 
not possible before. 

The general approach to discrete, digital 
events is discussed in Chapter (?), where 
input/output ports are presented. The hardware 
of interfacing digital inputs and outputs to 
electrical appliances and other 'real-world' 
devices is brilliantly described in TRS-80 
Interfacing (Volumes 1 and 2 — see 
Bibliography; especially check Volume 2, 
Chapter 1). 

This Chapter will present a few real-world 
interfacing projects, but will touch only lightly on 
the theory involved. If you plan to put together 
your own interfaces, turn to the references cited. 
Beyond that, here are some rules of thumb before 
you begin considering interfacing schemes or 
parts purchases: 

Output Interfacing 

TTL-level integrated circuits of the type used 
in your TRS-80 are capable of driving (running) 
little more than other TTL circuits like 
themselves or an occasional light-emitting diode 
(LED). Don't hook your computer expansion 
card onto any home-made electronic board 
unless it has TTL inputs; consider the 
computer's bus to be its most delicate hardware. 

For interfacing purposes, integrated circuit 
peripheral drivers are great. Use them to light 
small bulbs, turn on miniature relays, and to 
operate other low-voltage applications needing 
only limited current. Type 75452 is reliable and 
cheap, and takes abuse; it's the circuit used by 
the TRS-80 to run the video dot output and 
cassette relay. For LEDs, use individual 
transistors or the inexpensive type 500, 501 and 
502 digit and segment drivers. 

Isolation of hazardous voltages is essential for 
external equipment running from your 
computer. Consider anything plugged into 
house current to be potentially hazardous, 
because there's nothing like a power surge or 
unexpected short circuit to fry your '80 and 
maybe you too. Use opto-isolators and — or 
high-current relays for running electric stoves or 
even AC light bulbs. 

Always read the specifications of both the 
equipment you plan to interface and the device 



that's going to do the interfacing. Look for: 

- Average voltage and maximum voltage of 
the interfacing device, and operating voltage 
of the equipment to be run; the figure is 
given in volts (V), direct current volts 
(VDC), or alternating current volts (VAC). 
The interfacing device must always have a 
rating higher than the equipment to be run. 

- Average current and surge current of the 
the interfacing device, and operating current 
of the equipment to be run; the figure is 
given in amps (A) or milliamps (mA). The 
interfacing device must always have a rating 
higher than the equipment to be run. 

- Isolation voltage of the interfacing device. 
This device must have a rating roughly 67 
percent higher than the equipment to be 
run. 

Actually, interfacing peripheral equipment is 
one of the easiest things you can do with your 
TRS-80. Below is a simple schematic; it shows 
one latched output line from the computer, and 
how it might drive: 

(a) an LED 

(b) a relay 

(c) an ordinary house lamp 

(d) a motor 

(e) a high-voltage circuit. 

You wouldn't want to use this single line to do 
all these things, but you might want to combine 
the LED, house lamp, and motor. That way you 
could have an indicator near the computer that 
the motor is on, a bright lamp outside a building 
to indicate the motor is on, and the motor itself 
would go on. 

The point of this schematic is that it can be 
tapped at any point on the line of parts shown; 
use the parts only as far as you need them: 

Input Interfacing 

Counting events or determining occurrences 
has an easier group of rules: TTL level signals can 
interface right to other TTL devices with no 
work; just don't connect outputs together. 

Other on-off signals are interfaced with a 
device or group of devices which can shape the 
incoming signal into a neat, tight square wave, at 
TTL level. Such a device is called a Schmitt 
trigger, and is available as type 7414 for a few 
cents. 

If the signal is in the range of 4 to 7 volts, the 
Schmitt trigger will transform it to a fast-moving 
digital signal. If the signal occurs very often or is 
erratic or unstable in its rising voltage, then 
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Figure 7-7. Methods for interfacing the TRS-80. 
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D-to-A and A-to-D Conversion 



additional hardware or very tolerant software 
must be used. Use optical isolators to feed the 
computer or relays for interfacing higher 
voltages. 

For AC input, the signal may be transformed 
to about 3 to 6 volts, rectified to DC and filtered 
only if the signal is slow-moving (once a minute 
or so). Then the signal can be fed to a Schmitt 
trigger to the computer interface. Otherwise, the 
AC information can only be transformed to a 
lower voltage and its pulses (60 per second if it is 
ordinary house current) counted either by 
hardware or software. Don't interface AC if you 
can avoid it, because it can be a genuine pain in 
the bytes. Instead, have the AC run a fast relay 
and identify when the relay turns on and off. 



w» National 

£m Semiconductor 



A to D, D to A 



DAC0808. DAC0807, DAC0806 8-bit D/A converter 



general description 

The DAC0808 series is an 8-bit monolithic digitai-<Q- 
analog converter (DAC) featuring a tut! scale output 
current settling time of 150 ns while dissipating only 
33 mW with ±5V supplies. No reference current (i REF' 
trimming is required for most applications since the full 
scale output current is typically ±1 LSB of 255 IrEF' 
256. Relative accuracies of better than ±0.19% assure 
8-bit monotonicity and linearity whiie zero level output 
current of less than 4 jiA provides 8-bit zero accuracy 
tor IREF 5 2 mA. The power supply currents of the 
DAC0808 series are independent of bit codes, and 
exhibits essentially constant device characteristics over 
the entire supply voftage range. 

The DACO808 will interface directly with popular TTL, 
DTI or CMOS logic levels, and is a direct replacement 
for the MC1508/MC1408. For higher speed applications, 
see DAC0800 data sheet. 



±0.19% error maximum 



features 

a Relative accuracy: 

(DAC0808) 
o Full scale current match: ±1 LSB typ 
a 7 and 6-brt accuracy available (DAC0807, DAC08061 
a Fast settling time: 150 ns typ 
b Noninvenmg digital inputs are TTL and CMOS 

compatible 
b High speed multiplying input slew rate: 8 mA/^ts 
* Power supply voltage range: 2:4.5V to ±18V 
a Low power consumption: 33 mW @ ±5V 



biock and connection diagrams 
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FIGURE 1. ±10V Output DiBitnt to Anolofi Cortvortw 



ordering information 





OPERATING TEMPERATURE 
RANGE 


ORDER NUMBERS' 


ACCURACY 


D PACKAGE 1D16C) 


J PACKAGE (J16A) 


N PACKAGE {N16A1 


B-bii 


~55*C<Ta<-125 = C 


DAC0B08LD LM15G80-8 


DAC0808U 


LM150BJ-8 






B-bu 


; C<T A <*75°C 




DAC0808LCJ 


LM14Q8J-8 


DAC0808LCN 


LM1408N-8 


7-bil 


(fC<T A <*75 D C 




DAC0807LCJ 


LM140BJ'7 


OACO807LCN 


LM1408N-7 


6-bn 


= C < T A < +?5°C 


1 


DACOB06LCJ 


LMHOaj-6 


DAC0806l.CN 




LM1408N-5 



Signals from photocells and similar resistive 
devices can be fed through Wein bridges or 
merely fed into an operational amplifier. Again, 
the references such as TRS-80 Interfacing and 
Engineer's Notebook contain plenty of details on 
interfacing on-off signals. 

D-to-A and A-to-D Conversion 

Although some human events occur in on-off 
groups, most of life is pliable, elusive, and 
relative. It works by image and analogy, not by 
counting. It is an analog world, and the computer 
is a digital device. Faced with this dilemma, two 
important groups of electronic circuits have been 
developed: the digital-to-analog converter (D/A 
converter) and the analog-to-digital converter 
(A/D converter). 

The first class accepts a parallel digital input 
a given number of bits wide, and converts that to 
individual steps. For N steps, the number of 
distinct voltages or currents is 2 to the power N. 
The greater the number of bits, the lesser the 
relative size of the steps, to the point where the 
distinction between steps becomes insignificant. 
For an ordinary 8-bit data bus such as that on 
the TRS-80, the available voltage can be divided 
into 256 parts; for five-volt circuitry, this is 
0.0195 volts per step, starting at zero. If greater 
accuracy is essential, then 12-bit converters can 
be used (at greater expense), fed by one and one- 
half bytes of data from the computer. This 
provides 4,096 steps at 0.0012 volts per step. 
The most common 8-bit type is the DAC0808 
(National Semiconductor) or the MC1408L8 
(Motorola); data sheets are found in an 
Appendix. 

With present technology, conversion from 
analog signals to digital ones is much more 

application hints 

REFERENCE AMPLIFIER DRIVE AND COMPEN- 
SATION 

The reference amplifier provides a voltage at pin 14 for 
converting the reference voltage to a current, and a 
turn-around circuit or current mirror for feeding the 
ladder. The reference amplifier input current, ha. must 
always flow into pin 14. regardless of the set-up method 
or reference voltage polarity. 

Connections for a positive voltage are shown in Figure 7. 
The reference voltage source supplies the full i:ur'en: 
h4-. For bipolar reference signals, as in the multiplying 
mode, R15 can be tied to a negative voltage corres- 
ponding to the minimum input level. It is possible to 
eliminate R15 with only a small sacrifice in accuracy 
and temperature drift. 

The compensation capacitor value must be increased 
with increases in R14 to maintain proper phase margin; 
for R14 values of 1. 2.5 and 5 ki7. minimum capacitor 
values are 15, 37 and 75 pF The capacitor may be tied 
to either V££ or ground, but using Vgg increases 
negative supply rejection. 



Noie. Devices may be ordered bv using either order number. 



Figure 7-2. National Semiconductor data sheet example. 



164 



Chapter 7 



D-to-A and A-to-D Conversion 



absolute maximum ratings (T A = 25°C unless otherwise noted) 




Power Supply Voltage 


Power Dissipation (Package Limitationl 


. V CC 


5-5 Vqc Cavity Package 


1000 mW 


v EE 


-16.5 Vnr Derate above Ta a 25° C 


6.7 mW/"C 


Digital Input Voftsge, V5-VT2 -10 V DC to +18 V DC Operating Temperature Range 




Applied Output Voltage. Vq -11 


V Dc to+1SV DC DAC0808L 


-55'C<T A < *125'C 


Reference Current. ^4 


5 mA DACOBOSLC Series 


0£T A <+75'C 
-65'Cto+150'C 


Reference Amplifier Inputs. V14, V15 


Vcc- V EE Storage Temperature Range 


electrical characteristics 






(Vcc = 5V, V E E = -15 VDC. VreF-'RI 


4 = 2 mA, DAC0808L; Ta - -55°C to +12B°C, DAC0808LC. DAC0807LC 


DAC0806LC, Ta = C C to +75°C, and all digital inputs at high logic level unless otherwise noted.} 




PARAMETER 


CONDITIONS 


MIN 


TVP 


MAX 


UNITS 


E r Relative Accuracy {Error Relative 


(Figure 41 








% 


to Full Sea'? Iq' 
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application hintS- (Continued! 

A negative reference voltage may be used if R14 is 
grounded and the reference voyage .s app^ed to R15 as 
shown in Figure 8. A high inpu: impedance is the rrmn 
advantage of this method Compensation involves a 
capacitor to Vee on pin 16. using the values of the 
previous paragraph. The negative reference vouage must 
be at least 4V above the Vg£ supply Bipolar input 
signals may be handled by connecting R14 to a positive 
reference voltage equal to the peak positive input leve 1 
at pin 15. 

When a DC reference voltage is used, eapaotwe bypass 
to ground is recommended. Trie 5V tog<c supply is not 
recommended as a reference voitage If a wet! regulated 
5V supply which dnves log<c -s to be used as the refer- 
ence. R14 should be decoup-ed bv connecting it to 
5V through another resistor and bypassing the junction 
of the 2 resistors with 0.1 v? to ground. For reference 



voltages greater than 5V. a clamp diode ts recommended 
between pin 14 and ground. 

(f pin 14 is driven by a higr impedance such as a 
transistor current source, none of the above compensa- 
tion methods apply and the amplifier mus* be heavily 
compensated, decreasing the oweraii bandwidth 

OUTPUT VOLTAGE RANGE 

The voltage on pin 4 is restricted to a range of -0.6 to 
0.5V when Vee = — 5V due to the current switching 
methods employed in the DACG808. 

The negative output voltage compliance of the DAC0808 
is extended to — 5V where the negative supply voltage is 
more negative than -10V. LH;ng a full-scale current of 
1.992 mA and ioad resistor of 2.5 k£Z between pin A 
and ground will yield a voltage output of 256 levels 
between and —4.980V. Floating pm 1 does not affect 



the converter speed or power dissipation. However, the 
value of the load resistor determines the switching time 
due to increased voltage swing Values of R\_ up to 
50G£2 do not significantly affect performance, but a 
2.5 kfi load increases worst-case settling time to 
1.2 ys (when all bits are swtched ON). Refer to the 
subsequent text section on Settling Time for more 
details on output loading. 

OUTPUT CURRENT RANGE 

The output current maximum rating of 4.2 mA may be 
used only for negative supply voltages more negative 
than — 7V. due to the increased voltage drop across the 
resistors in the reference current amplifier. 

ACCURACY 

Absolute accuracy is the meas-j-e of each output current 
level with respect to its intenoec value, and is dependent 
upon relative accuracy and fuii-scale current drift. 
Relative accuracy ts the measure of each output current 
level as a fraction of the fuh -scale current. The relative 
accuracy of the DAC0808 is essentially constant with 
temperature due to the exceiient temperature tracking 
of the monolithic resistor ladder. The reference current 
may drift with temperature, causing a change in the 
absolute accuracy of output current. However, the 
DAC0808 has a very low full-scale current drift with 
temperature. 



The DAC0808 series is guaranteed accurate to within 
±1/2 LSB at a full-scale output current of 1.992 mA. 
This corresponds to a reference amplifier output current 
drive to the ladder network of 2 mA. with the loss of 
I LSB (8 /jAI which is the ladder remainder shunted to 
ground. The input current to pin 14 has a guaranteed 
value of between 1.9 and 2.1 mA, allowing some mis- 
match in the NPN current source paT. The accuracy test 
circuit is shown in Figure 4. The 12-bit converter is 
calibrated for a full-scale output current of 1.992 mA. 
This is an optional step since the DAC0808 accuracy is 
essentially the same between 1.5 and 2 5 mA. Then the 
DAC0808 circuits' full-scale current is trimmed to the 
same value with R14 so that a zero value appears at the 
error amplifier output. The counter is activated and the 
error band may be displayed on an oscilloscope, detected 
by comparators, or stored in a peak detector. 

Two 8-bit D-to-A converters may not be used to 
construct a 16-bit accuracy D-to-A converter. 16-bit 
accuracy implies a total error of ±1/2 of one part in 
65,536, or ±0.00076%, which is much more accurate 
than the zQ.019% specification provided by the 
DAC0808. 

MULTIPLYING ACCURACY 

The DAC0808 may be used in the multiplying mode 
with 8-bit accuracy when the reference current is varied 
over a range of 256:1. If the reference current in the 
multiplying mode ranges from 16 jjA to 4 mA, the 
additional error contributions are less than 1.6jiA. This 
is well within 8-bit accuracy when referred to full-scale. 

A monotonia converter is one which supplies an increase 
in current for each increment in the binary word. 
Typically, the DAC0808 is monotomc for alt values of 
reference current above 0.5 mA. The recommended 
range for operation with a DC reference current is 0.5 to 
4 mA. 

SETTLING TIME 



The worst-case switching condition occurs when all 
bits are switched ON. which corresponds to a low-to-high 
transition for all bits. This time ts typically 150 ns 
for settling to within ±1/2 LSB, for, 8-bit accuracy, 
and 100 ns to 1/2 LSB for 7 and 6-bit accuracy. The 
turn OFF is typically under 100 ns. These times apply , 
when Rj_ < 500^ and Cq < 25 pF 

Extra care must be taken in board layout since this is 
usually the dominant factor in satisfactoy test results 
when measuring settling time. Short leads, 100 yF 
supply bypassing for low frequencies, and minimum 
scope lead length are all mandatory. 



The Custom TRS-80 



165 



Music and Sound Effects 



complicated. Most commonly used is a 
technique which compares the input voltage to 
known voltages inside the converter. When a 
match is found, a binary version of the input 
condition is fed to the computer bus. This 
process is slow when compared to computer 
speeds, and such devices usually have 
start-of-conversion and end-of-conversion 
signals so the computer will not receive false data 
by attempting to read the converter's 
information during the conversion process. The 
commonly used 8-bit type is ADC0800 (National 
Semiconductor); see the Appendix. 

Music and Sound Effects 

There are other ways of producing sound using 
the TRS-80 which do not involve exclusively 
software. The software-only approach may be 
capable of producing sound effects, but in the 
TRS-80 configuration it cannot provide any 



spatial effects (it is monaural only), nor can it 
offer a large variety of textures. For these, the 
TRS-80 user must turn to a little extra 
hardware. 

Simplest among the extra hardware is a 
latched output address. The information 
written to the address appears at the output of 
the latch. Write to the address fast enough, and 
sound is produced, because the latch acts as a 
kind of electronic window to that single memory 
location. Feed that digital activity through a 
few resistors to blend the sounds, and run that to 
a stereo amplifier. Voila! Spatial sound. 

The circuit presented here contains an 8-bit 
latch (Zl), and address decoder (Z3, Z4 and Z4, 
mapped to 4FFF), and three-state output buffer 
(Z2). The computer data is latched into Zl when 
WRite to 4FFF appears at Z3/4/5. Depending on 
the data at Zl, any or all of the four buffers in Z2 
may be turned on or off. 
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Figure 7-3. Simple sound synthesis circuit 
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Figure 7-4, Alternate decoding scheme. 



An alternate decoding (8FFF) is provided, 
and is recommended for some of the musical 
selections presented. The selections include my 
own arrangement of 'God Rest Ye Merry 
Gentlemen', first presented in the Christmas 
1980 issue of 80 Microcomputing; and 'Your 
California', a suite by David Gunn, originally 
composed for viola duo. The latter group is 
written for use with the Exatron Stringy-Floppy, 
and will continuously repeat the four parts of the 
suite. 

There are two versions of the software; both 
are identical, except that the second is a two- 
voice program intended for pieces such as 'Your 
California'. Because the TRS-80 is slow (1.77 
MHz) and the Z-80 is slow (an enormous 
number of machine cycles per instruction when 
compared with other microprocessor families), 
four-part music will reproduce in the low 
register. The two-part music is much more 
satisfying musically. 
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Figure 7-5. Music notation for people. 



The Custom TRS-80 167 



Music and Sound Effects 




Figure 7-6. The same music for the computer. 
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10 HEM * CLEARING SPACE FOR PROGRAM CHAINING SEQUENCE 
20 P0KE16634,PEEK[16634)+16 : REM * SIMPLE VARIABLE POINTER 
30 CLEAR50 : REM * CLEAR STRING SPACE AND RESET POINTERS 
40 8L0AD3 : HEM * BRING NEXT PROGRAM IN FROM STRINGY FLOPPY 



10 0UT254,2 : CLS : PRINT"READING. ." : REM * 0UT254.2 = HISPEED 
20 X = 2457B : REM * THIS IS MEM. POSITION OF VOICE NUMBER ONE 
30 READ A : IF A = 999 THEN 50 ELSE POKE X,A : REM * EXIT <8 999 
40 X = X + 4 : GOTO 30 : HEM * VOICE APPEARS EVERY 4 MEM LOC'NS 
50 X = 24579 : REM ' THIS IS MEM. POSITION OF VOICE NUMBER TWO 
60 READ A : IF A = 999 THEN BO ELSE POKE X,A : REM * PITCH POKE 
70 X = X + 4 : GOTO BO : REM * VOICE APPEARS EVERY 4 MEM LOC'NS 
80 X = 24576 : REM * THIS IS THE BEGINNING VALUE FOR OURATIONS 
90 READ A : IF A = 999 THEN 110 ELSE POKE X,A*2 : BEM * RHYTHMS 
100 X = X + 4 : GOTO 90 : REM * NOTICE RHYTHM MULTIPLIER ABOVE 
110 RESTORE : REM * THIS GETS THE DATA POINTER BACK TO START 
120 X = 24577 : REM * THESE LOCATIONS USED FOR SUBTLE DURATIONS 
130 READ A : IF A = 999 THEN 150 ELSE POKE X,1 : REM * RHYTHMS 
140 X = X + 4 : GOTO 130 : REM * NO CHANGE IN LSB TIMING ABOVE 
150 POKE X,0 : POKE X+4,0 : POKE X+8,0 : REM * MUSIC END CODE 
160 0UT254.3 : POKE 16526,96 : POKE 16527,143 : M=USR10) :CLEAR 
170 6L0AD4 : REM * PLAY NORM SPEED, USR CALL, CLEAR, LOAD NEXT 
1B0 DATAO.0, 0,0,0 ,0,0 ,0,22, 26 ,30, 30, 30, 30 ,30, 34,34,34,0, 0,0,0,0 
190 DATA20, 16, 13, 14, 14, 14, 14, 14, 15, 15, 15, 0,0 ,0,0, 0,0,20,18,18 
200 DATA18, 18, 24 ,0.24, 0,24, 0,24, 0,24, 24, 24 ,0,24, 0,24, 24, 0,24,0 
210 DATA24, 24, 0,24, 0,24, 24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24, 0,24,0 
220 DATA22, 22, 18, 18.16,16, 14, 14, 13, 13, 12, 13. 13, 13, 14, 19, 27, 19 
230 DATA13, 13, 14, 19, 27, 19, 13, 0,16, 0,20 ,0,22, 0,24, 0,24, 0,24, 0,24 
240 DATAO, 20, 16, 13, 14, 14, 20, 16, 13, 0,16, 0,16, 0,16, 12,1 2, 12, 12,13 
250 DATA15, 15, 15, 15, 18,21 ,21 ,21 ,21 ,16, 16, 0,16, 0,16, 16, 0,16, 0,16 
260 DATA17.15 : REM * end of page one for voice one 
270 DATA20, 21 ,24, 26, 0,0, 0,0 ,0,22, 26 ,30 ,30, 30, 30 ,30, 34 ,34,34 ,0,0 
2B0 DATAO, 24, 0,24, 24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24, 0,0, 0,20 ,18 
290 DATA18, 18, 1B. 24, 0,24, 0,24, 0,21 ,0,22,0,18,0,30,30,32,0,24,0 
300 DATA24.D. 24, 0,24, 0,26, 21 ,16, 16, 16, 16, 16, 16, 16, 16, 16, 999 
310 REM * THIS IS THE END OF THE PITCH SEQUENCE FOR VOICE ONE 
320 DATA24, 0,24, 0,24, 0,24, 0,24, 24, 24,0, 24, 0,24, 24, 0,24, 0,24,0 
330 DATA24. 0,24, 24, 24, 24, 0,24, 0,24, 24, 0,24,0, 24, 24, 0,24,0, 26,25 
340 DATAO, 26, 0,27, 0.27, 0,27, 0,40 ,0,22, 26 ,30. 30,30, 30, 30,34, 34 
350 DATA34, 0,0, 0,0, 0.0, 20, 16. 13. 14, 14, 14, 14, 14, 15, 15, 15, 15, 0,0 
360 DATAO, 0,27 ,30 ,32,36, 40, 20, 18, 36, 40, 20, 18,36, 40, 20 ,18,18.36 
370 DATA36, 40, 20, 18,18,36 ,36, 40 ,0,30, 0,26 ,0,32, 0,27, 0,27 ,0,30 
380 DATAO, 40, 0,22, 22, 22, 26 ,30 ,34, 34, 34, 0,24, 0,24,0, 24, 24, 0,24 
390 DATAO, 24, 24, 0,24, 0,24, 24, 0,24, 0,24, 26, 26, 26, 26, 22,30 ,30, 30 
400 0ATA30,32,32,32 : REM * end of page one for voice two 
410 DATA32, 32,32, 0,0, 24, 0,24, 0,24, 24, 24, 0,24,0, 24, 24, 0,24, 0,24 
420 DATAO, 0,20, 16, 13, 14, 14, 14, 14, 14, 15, 15, 15, 0,0, 0,24, 0,26, 26 
430 DATAO. 26 ,0,27, 0,27, 0,30, 0,30, 0,32, 32, 32, 32, 32, 0,0, 0,34,0 
440 DATA34, 0,34, 0,34, 0,32, 29,24, 24, 26, 24, 26, 24, 26, 28, 26, 999 
450 REM * this is the conclusion of the score for voice two 
460 DATA10, 2, 2, 2, 10, 2, 2, 2, 4, 4, 2, 2, 2, 2,9,2,2,2, 2,10, 2, 2, 2,3 .3 ,3 
470 DATA2, 2. 2, 2, B, 2, 2, 2, 2, B, 2, 2, 2. 2, 8, 2, 2, 2, 2,10, 2, 2, 2, 10, 2, 2, 2 
480 DATA4. 4, 2, 2, 2, 2, B, 2, 2, 2. 2, B, 2, 2, 2, 2,3 ,3 ,3, 2, 2,2, 2, B, 2, 2, 2, 2 
490 DATA10, 2, 2, 2, 4, 4, 4, 4, 8, 8, 8, 8, 8, B,B, 8, 8, 6,4,4,4,4, 8, 8, 4, 4, 4 
500 DATA4, 10, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2, 3, 3 ,3, 8, 8, 3,3 ,3 
510 DATA8, 10, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2,2,2,8,2,2,2, 2, 8 
520 DATA2,2,2,2,8,8,8 ; REM * end of page one for durations 
530 DATAB, 8, 16, 8, 8, 10, 2, 2, 2. 4, 4, 2, 2, 2, 2, B, 2, 2. 2, 2, 10, 2, 2, 2,3 ,3 
540 DATA3, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2 
550 DATA2. 10, 2, 2, 2, 2, 2, 4. 8, 10, 2, 2, 2.10, 2, 2, 2,4,4,8,8,1 ,1 ,1 ,1 ,3 
560 DATA6,20,999 : REM * end of scope for durations; end score 



Listing 7-1. Examples of music programs. 



More Music 

Naturally, there is much more to the creation 
of music by computer than the mere sounding of 
tones; the appearance of commercial 
music-generation peripherals for the TRS-80 
attests to that. But though they may be 
well-designed pieces of electronics, composers 
and others serious about producing listenable 
music tend to look for richer sounds and more 
flexible ways to change that sound. 

There are several ways to do this. The simplest 
is the tone generator with a tempered scale, 
capable of producing chordal sounds (consisting 
of three or more pitches sounding 
simultaneously). The tone color is limited to a 
fixed palette, and they are suitable for making 
elementary music. I refer to these generically as 
'organs' because their tone colors usually give the 
illusion of organ stops. Most TRS-80 compatible 
music boards are simplified variations on the 
basic electronic organ, using integrated circuit 
chips like the General Instrument AY-3-8910 
and the Texas Instrument SN76489. 

A second group of electronic instruments 
creates music by constructing waveforms from a 
pre-assigned table of values. Thus, tone color, 
pitch, and volume can be altered by the selection 
of parameters in the table. This is digital 
synthesis in an elementary form, just one step 
beyond the simple software tone generation 
presented earlier in this Chapter. The TRS-80 is 
not capable of operating either with enough 
speed or electronic flexibility for digital 
synthesis. 

Peripheral to the digital synthesis of tones is 
the electronic creation of vocal sounds. Texas 
Instruments, Votrax and other integrated 
circuits use a complex algorithm called 'linear 
predictive coding' to select from a known subset 
of human vocal sounds. Although somewhat 
convincing voices can be produced this way, mere 
intelligibility is the least significant criterion in 
music. Until (and if) predictive devices are 
developed for a wide array of musical sound, they 
have no application for producing music. 

The most popular electronic music makers for 
more than a decade have been the analog 
synthesizers. Traditional oscillators create a 
sound which can be mutated and transformed 
until its color is right. These synthesizers were 
never conceived in computer-compatible terms, 
but companies such as PAIA have for the past 
few years offered hybrid analog-digital systems 
where the computer is used as a super-sequencer, 
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keeping the notes in order for storage and 
playback. 

There are several reasons why I suggest 
interfacing analog synthesizers to the TRS-80. 
First, analog synthesizers are cheap. Small, 
capable machines can be picked up for the cost 
of a TRS-80, and kits are sold by PAIA and 
others for less than $100. Surplus synthesizers 
are also available (Moog, Buchla, PBI, Putney, 
and others of early 1970's vintage) at low cost. 
All of these will take on new musical life when 
interfaced to the TRS-80. 

Second, if you are a performing musician, it's 
likely you're looking for a musical instrument, 



and it's in that area where the analog synthesizer 
is still champion. They are performance 
instruments, not electronic widgets. And with a 
computer interface, they remain stand-alone 
performance instruments, but with computer 
assistance where it is wanted. 

Figure 7-7 presents the circuit for a 2- to 
32-voice analog synthesizer interface. The basic 
circuit contains a data-line buffer (Zl), a buffer 
for the most used addresses (Z4), a port decoder 
and a voice-pair selector (Z2/Z3). In a fully 
expanded system, sixty-four ports (port 64 to 
port 127) are used to provide thirty-two voltage 
outputs, sixty-four envelopes, with sixty-four 
additional control lines. 
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Figure 7-7. TRS-80 to voltage-controlled synthesizer interface. 
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10 OUT 254,2 : CLS : PRINT"READING. ." : HEM 0UT254.2 = HISPEED 
20 X = 24578 : REM » THIS IS MEM. POSITION OF VOICE NUMBER ONE 
30 READ A : IF A = S99 THEN 50 ELSE POKE X,A : REM » PITCH POKE 
40 X = X + 4 : GOTO 30 : REM * VOICE APPEARS EVERY 4 MEM LOC'NS 
5D X = 24579 : REM « THIS IS MEM. POSITION OF VOICE NUMBER TWO 
BO READ A : IF A = 99S THEN 80 ELSE POKE X,A : REM * PITCH POKE 
70 X = X + 4 : GOTO 60 : REM » VOICE APPEARS EVERY 4 MEM LOC'NS 
BO X = 24576 : REM * THIS IS THE BEGINNING VALUE FOR DURATIONS 
90 READ A : IF A = 999 THEN 110 ELSE POKE X,A*2 : REM * RHYTHMS 
100 X = X + 4 : GOTO SO : REM * NOTICE RHYTHM MULTIPLIER ABOVE 
110 RESTORE : REM * THIS GETS THE DATA POINTER BACK TO START 
12Q X = 24577 : REM * THESE LOCATIONS USED FOR SUBTLE DURATIONS 
130 READ A : IF A = 999 THEN 15D ELSE POKE X.1 : REM * RHYTHMS 
140 X = X + 4 : GOTO 130 : REM * NO CHANGE IN LSB TIMING ABOVE 
150 POKE X,0 : POKE X+4,0 : POKE X+B,0 : REM * MUSIC END CODE 
160 0UT254.3 : POKE 16526,98 : POKE 16527,143 : M=USR[0) :CLEAR 
170 (8L0AD4 : REM * pLAY NORM SPEED, USR CALL, CLEAR, LOAD NEXT 
1B0 DATAO, 0,0, 0,0, 0,0, 0,22, 26 ,30 ,30,30, 3D, 30 ,34,34,34, 0,0, 0,0,0 
190 DATA20, 16, 13 ,14, 14, 14, 14, 14, 15, 15, 15, 0,0,0,0, 0,0, 20 ,18,18 
200 DATA18, 18, 24, 0,24, 0,24, 0,24, 0,24, 24, 24, 0,24, 0,24, 24, 0,24,0 
210 DATA24, 24, 0,24, 0,24,24,24, 24.0, 24, 0,24, 24, 0,24, 0,24, 0,24,0 
220 DATA22, 22, 18, 18, 18, 16, 14, 14, 13, 13, 12, 13, 13, 13, 14,19, 27, 19 
230 DATA13, 13, 14, 19. 27 ,19, 13, 0,16,0. 20, 0,22, 0,24,0, 24, 0,24,0 
240 DATA24, 0,20 ,16, 13, 14. 14, 20, 16, 13, 0,16, 0,16, 0,16, 12, 12, 12,1 2 
250 DATA13. 15, 15. 15,15,16, 21 ,21 ,21 ,21 ,16, 16, 0,16, 0,16,16, 0,16.0 
260 DATA16,17,15 : REM * END OF PAGE ONE FOR VOICE ONE 
270 DATA20, 21 ,24, 26, 0,0, 0,0, 0,22, 26, 30,30,30,30,30,34,34,34, 0,0 
280 DATAO, 24, 0,24, 24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24, 0,0, 0,20 ,18 
290 DATA18, 18, 18. 24, 0,24, 0,24, 0,21 ,0,22.0,18,0,30,30,32,0,24,0 
300 DATA24, 0,24, 0,24, 0,26, 21 ,16,16,16,16,16,16,16,16,16,999 
310 REM END OF PAGE TWO FOR VOICE ONE 

320 DATA24, 0,24, 0,24. 0,24, 0,24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24,0 
330 DATA24, 0,24, 24, 24,24, 0,24, 0,24,24,0, 24, 0,24, 24,0, 24,0, 26 
340 DATA26, 0,26, 0,27, 0,27, 0,27 ,0,40, 0,22, 28 ,30 ,30, 30, 30,30, 34 
350 DATA34, 34, 0,0, 0,0, 0,0. 20 ,16, 13, 14, 14, 14,14,14,15,15,15, 15 
360 DATAO, 0,0, 0,27 ,30, 32,36, 40, 20, 18, 36, 40, 20, 18,36, 40, 20 ,18, 18 
370 DATA36, 36, 40, 20. 18, 18,36,36, 40 ,0,30, 0,26 ,0,32, 0,27 ,0,27,0 
380 DATA30, 0,40 ,0,22, 22, 22, 26 ,30 ,34,34,34, 0,24,0, 24, 0,24,24,0 
390 DATA24, 0,24, 24,0. 24,0, 24, 24, 0,24,0, 24, 26, 26, 26, 26 ,22,30, 30 
400 DATA30,30,32,32.32 : REM * END OF PAGE ONE FOR VOICE TWO 
410 DATA32, 32, 32, 0,0, 24, 0,24, 0,24, 24, 24, 0,24, 0,24, 24,0, 24, 0,24 
420 DATAO, 0,0, 20 ,16, 13 ,14, 14,14,14,14, 15, 15. 15, 0,0, 0,24, 0,26, 26 
430 DATAO, 26 ,0,27. 0.27, 0,30, 0,30, 0,32, 32,32,32,32,0, 0,0,34,0,34 
440 DATAO, 34, 0,34, 0,32, 28, 24, 24, 26, 24, 26 ,24, 26, 28, 26, 999 
450 REM * END OF PAGE TWO FOR VOICE TWO 

460 DATA10, 2, 2. 2, 10, 2, 2, 2, 4, 4, 2, 2, 2. 2, 8, 2, 2, 2, 2, 10, 2, 2, 2,3 ,3 ,3 
470 DATA2, 2, 2, 2, 8, 2, 2, 2, 2. 8,2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2,10, 2, 2, 2 
480 DATA4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2,3 ,3, 3 ,2, 2, 2, 2, 8, 2. 2, 2, 2 
490 DATA10, 2, 2, 2, 4, 4, 4, 4,8,8,8,8,8.8, 8, 8, 8. 8, 4, 4, 4, 4, B, 8, 4, 4, 4 
500 DATA4, 10, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2,3 ,3 ,3, 8, B, 3 ,3 ,3 
510 DATAB, 10, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, B, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8,2 
52D DATA2,2,2,8,8,8 : REM * END OF PAGE ONE OF RHYTHMS 
530 DATAB, 8, 16, 8, 8, 10, 2, 2, 2, 4, 4, 2, 2, 2, 2, 8, 2, 2. 2, 2, 10, 2, 2, 2,3 ,3 
540 DATA3, 2, 2, 2, 2, 8, 2, 2, 2, 2,10, 2, 2, 2, 8,2,2, 2, 2, 10, 2, 2, 2,10, 2, 2 
550 DATA2, 10, 2, 2, 2, 2, 2, 4, 6,10,2,2,2, 10, 2, 2, 2, 4, 4, 8, 8,1 ,1 ,1 ,1 ,3 
560 DATAB, 20, 999 : REM * END OF RHYTHMS PAGE TWO AND END PIECE 



Each pair of voices is managed by 
programmable peripheral interface Z5, which 
provides two 8-bit outputs to digital-to-analog 
converters Z6 and Z7, offering one-part-in-256 
accuracy. Remaining from Z5 are eight control 
lines for envelope, etc. Optionally, six of these 
remaining control outputs can be used for 
voltage control of volume or filtering (see Figure 
7-7 ), which can be used with less resolution 
(one part in 64) than that needed for pitch 
control. 

Figure 7-8 is the power supply, which is 
similar to others in this book with the exception 
of the LM340-8, providing eight volts as a 
reference to the digital-to-analog converters. 

The output of the D/A converters Z6 and Z7 is 
in the range of volts to 4.98 volts, which should 
be more than adequate to drive most 
synthesizers across their full range. The 
envelope triggers provided by Z8 and Z9, 
however, may need tweaking depending on the 
type of synthesizer you are using. Some synthos 
require a negative-going pulse, and others need a 
positive-going one; likewise, some synthos trigger 
on the rising or falling edge of the wave, while 
other envelopes will sustain as long as the level of 
the trigger signal remains high or low. Thus, the 
resistance and capacitance values given for Z8 
and Z9 may have to be changed for sustained 
envelope triggers, or Z8 and Z9 might be 
eliminated completely if the envelope is 
edge-triggered. If you don't have specs on your 
synthesizer, build the trigger circuit up, then 
down, until it works for your machine. 




*A ZENER DIODE WITH CURRENT 
LIMITING MAY BE USED. 



> + 8 

(FOR VREF) 



">+5 



->-!5 



Figure 7-8. Power supply for the synthesizer interface. 



The Custom TRS-80 
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More Music 



Synthesizer Interface Port Addressing 
Port Function 



10 0UT254.2 : 
20 X = 24578 
30 BEAD A : IF . 
40 X = X + 4 
SO X = 24579 
60 READ A : IF 
70 X = X + 4 
8D X = 24576 



CLS ; PRINT"READING.." : REM s 0UT254.2 = HISPEED 
: REM * THIS IS MEM. POSITION OF VOICE NUMBER ONE 
A = 99S THEN 50 ELSE POKE X.A : REM * EXIT @ 993 
GOTO 30 : REM * VOICE APPEARS EVERY 4 MEM LOC'NS 
REM 4 THIS IS MEM. POSITION OF VOICE NUMBER TWO 
■A = 999 THEN 80 ELSE POKE X.A : REM * PITCH POKE 
GOTO 60 : REM * VOICE APPEARS EVERY 4 MEM LOC'NS 
REM * THIS IS THE BEGINNING VALUE FOR DURATIONS 
90 READ A : IF A = 999 THEN 110 ELSE POKE X,A*2 : REM * RHYTHMS 
10D X = X + 4 : GOTO 90 : REM * NOTICE RHYTHM MULTIPLIER ABOVE 
110 RESTORE : REM * THIS GETS THE DATA POINTER BACK TO START 
120 X = 24577 ; REM * THESE LOCATIONS USED FOR SUBTLE DURATIONS 
130 HEAD A : IF A = 999 THEN 150 ELSE POKE X,1 : REM * RHYTHMS 
140 X = X + 4 : GOTO 130 : REM * NO CHANGE IN LSB TIMING ABOVE 
150 POKE X.O : POKE X+4.0 : POKE X+B.O : REM * MUSIC END CODE 
160 0UT254.3 : POKE 16526,96 : POKE 16527,143 : M=USR[0) :CLEAR 
170 8L0AD6 : REM * PLAY NORM SPEED, USR CALL. CLEAR, LOAD NEXT 
180 DATAO, 0,0, 0,0, 0,0 ,0,25, 29, 31 ,29,3,0,0,0,0,20,16,13,14,14,14 
190 DATA14. 14,15, 15,15.0, 0,0,0 ,0,0, 20, 18, 1B, 18, 18, 24.0, 24, 0,24 
2D0 DATAO, 24, 0,24, 24. 24. 0,24, 0,24, 24,0.24,0, 24, 24, 0,24, 0,24, 24 
210 DATA24, 24, 0,24, 0,24, 24, 0,24, 0,24, 0,24, 0,22, 22, 18, 18, 16, 16 
220 DATA14. 14, 13. 13, 12, 13. 13, 13, 14, 19, 27, 19, 13, 13, 14, 19, 27, 19 
230 DATA13, 0,16, 0,20,0, 22,0, 24, 0,24,0, 24,0, 24,0 .12,1 2,1 2,1 2, 13 
240 DATA15,15,15,15,18,21 ,21 ,21 ,21 ,16,16.0,16,0,16,16,0,16,0,16 
250 DATA17.15 : REM * END OF PAGE ONE FOR VOICE ONE 
260 DATA3 ,140 ,3, 22. 26 ,30 ,30,30, 30,30,34 .34,34,0 ,0,0. 24,0,24, 24 
270 DATA24, 24, 0,24, 0,24, 24, 0,24, 0,24. 0,0, 0,20,18,18,18. 18,24,0 
28D DATA24. 0.24, 0,21 ,0,22, 0,18, 0,30, 30, 32, 0,24, 0,24,0, 24. 0,24,0 
29D DATA26, 21 ,16,16,16,16,16,16,16,16,16,999 : REM * END P2V1 
300 DATA24, 0,24, 0,23 ,3, 135,1 ,1 ,42,0,24,0,24,0,24,24,24,24,0,24 
310 DATAO, 24, 24, 0,24, 0,24, 24, 0,24, 0,26, 26, 0,26 ,0,27, 0,27, 0,27,0 
320 DATA40, 0,22, 26 ,30,30, 30, 30. 30, 34 ,34,34, 0,0 ,0,0, 0,0, 20 ,16, 13 
330 DATA14.14, 14, 14,14, 15, 15.1 5,1 5.0 ,0,0 ,0,27 ,30,32,36, 40, 20 
340 DATA1 8,36,40, 20, 18, 12, 140 ,140, 13, 3, 40, 20, 18, 18,36,36,40,0 
350 DATA30, 0,26, 0,32, 0,27, 0,27 ,0,30, 0,40 .0,22, 22, 22, 26 ,30,34,34 
360 DATA34, 0.24. 0,24, 0,24, 24, 0,24, 0,24, 24, 0.24, 0,24, 24, 0,24,0 
370 DATA24, 26, 26, 26, 26, 22,30.30, 30.30,32,32,32 : REM * END P1V2 
380 DATA32, 32, 32, 0,0, 24, 0,24, 0,24, 24, 24, 0,24, 0,24, 24, 0,24, 0,24 
390 DATAO ,0,0, 20,16, 13,14,14,14,14,14,15,1 5, 15.0,0,0, 24,0, 26, 26 
400 DATAO, 26, 0,27. 0,27, 0.30, 0.30, 0,32, 32,32,32,32, 0,0, 0,34, 0,34 
410 DATAD , 34, 0, 34, 0,32, 28, 24, 24, 26, 24, 26, 24, 26, 2B, 26, 999 
420 REM * END OF PAGE TWO FOR VOICE TWO 

430 DATA10. 2, 2, 2, 10, 2, 2, 2, 4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10. 2. 2, 2,3 ,3 ,3 
440 DATA2, 2, 2, 2, 8,2, 2, 2, 2, B, 2, 2, 2, 2, 8, 2. 2, 2, 2, 10, 2, 2, 2, 10, 2, 2, 2 
450 DATA4, 4, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2,3 ,3 ,3, 2, 2, 2, 2, 8, 2, 2, 2, 2 
460 DATA1 0, 2, 2, 2, 4. 4, 4, 4, 8, 8, 8, 8, 8, 8, 8, 8,8, 8,4, 4, 4, 4. 8,3,1 1,5, 4 
470 DATA10,2,2,2,10,2,1,1 ,10,2,2,2.10,2,2,2,3,3,3,8,8,3,3,3,8 
480 DATA10, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2, 2, 2, 8, 2, 2 
49D DATA2.2.8.8.8 : REM s END OF PAGE ONE OF RHYTHMS 
500 DATA8, 8, 16, 8, 8, 10, 2, 2, 2, 4, 4, 2, 2, 2, 2, 8, 2. 2, 2, 2, 10, 2, 2, 2,3 ,3 
510 DATA3, 2, 2, 2, 2, 8, 2, 2, 2, 2, 10, 2, 2, 2, B, 2, 2, 2, 2, 10, 2, 2, 2, 10, 2, 2 
520 DATA2, 10, 2, 2, 3, 13, 5, 9, 2, 2, 2. 12. 10, 2, 2, 2, 4. 4, 8, 8.1 ,1,1 ,1,3,6 
530 DATA20,999 : REM 4 END PAGE TWO OF RHYTHMS AND END PIECE 



Port Number 


Port Number 


[Decline 


I) 


(Hex) 


64 




40 


65 




41 


66 




42 


67 




43 


68 




44 


69 




45 


70 




46 


71 




47 


72 




48 


73 




49 


74 




4A 


75 




4B 


76 




4C 


77 




4D 


78 




4E 



Pitch Control Voice 1 
Pitch Control. Voice 2 
Envelopes 1 a/b and 2 
Extra Lines 1 a/b and 
Port Control Voices 1 
Pitch Control. Voice 3 
Pitch Control. Voice 4 
Envelopes 3 a/b and 4 
Extra Lines 3 a/b and 
Port Control Voices 3 
Pitch Control Voice 5 
Pitch Control Voice 6 
EnveLopes 5 e/b and 6 
Extra Lines 5 a/b and 
Port Control Voices 5 
Pitch Control Voice 7 
Pitch Control Voice 8 
Envelopes 7 a/b and 8 
Extra Lines 7 a/b and 
Port Control Voices 7 



a/b 
2 a/b 

- 2 



a/b 
4 a/b 

- 4 



a/b 
6 a/b 
- 6 



a/b 
8 a/b 



124 


7C 


125 


7D 


126 


7E 


127 


7F 


Table 7-1. S 


ynthesizer 



Pitch Control Voice 31 
Pitch Control Voice 32 
Envelopes 31 a/b and 32 a/b 
Extra Lines 31 a/b and 32 a/b 
Port Control Voices 31 - 32 



Synthesizer interface port addressing. 

Using the synthesizer interface is 
straightforward. Plug the interface into the 
TRS-80 expansion connector, and run shielded 
microphone cable from the voltage outputs of 
the interface to the voltage inputs (marked 
'control in', 'voltage in', 'VCO control', 'external 
in', or something similar) on the synthesizer. 
Then run either parallel speaker wire or shielded 
cable from the interface envelope (positive-going 
edge) to the synthesizer's envelope inputs. The 
integrated circuits running from the interface 
are not balanced for long lines; if you plan to use 
more than a dozen feet of cable, place 7417 open- 
collector buffers at each control output from the 
interface, so: 



7417 
[PART) 




SHIELDED CABLE 




SYSTEM 
POSITIVE 
VOLTAGE 
K30V) 



SYNTHO 

TRIGGER 

BLOCK 



J, 4 J~A 



Chapter 7 



More Music 



10 0UT254,2:CLS:PRINT"READING 

T2 X=24578 

15 READA:IFA=999THEN30ELSEP0KEX. 

3D X=2457S 

35 READA:IFA=999THEN50ELSEPQKEX, 

50 X=24S76 

55 READA:IFA=989THENB0ELSEPOKEX, 

80 HEST0RE:X=2457? 

90 READA:IFA=99STHEN97ELSEP0KEX, 

97 0UT254,3;P0KEX+4,0;P0KEX+8,Q: 

98 SLQAD3 

ioo data20, 20.20, 20,20, 20,20,1a, 

110 DATA24,24,21,27,2G,27,27.27, 

120 DATA16,16,27,24,4Q,4a,48,44, 

130 DATA11 ,9,9,9,12,11 ,12,10,21 , 

140 DATA28,28,28, 27, 24,19,17.17, 

150 0ATA19,ia,38,27,30,30,2a,38, 

160 DATA14, 27, 24, 21 ,20.21 ,16,14, 

170 oata32.32,32,32,32,32,32,32 : 

180 DATA20, 20, 20, 20, 20,20,20. 18, 

150 DATA24, 24, 21 .27,26.27,27,27, 

200 0ATA34,34,32,42,42,38,3B,34. 

210 0ATA13, 13, 14. 16,18, 18,18. 17 

220 DATA17, 17, 17, 17,18,16,14,13 

230 DATA24,24,20,30,38,38,40,36 

240 REM END OF PAGE 1 

250 DATA3B,44.32,32,34.40,28,2B 

260 DATA40.40,38.44,32.32,34,40 

270 DATA20,20,20.20.20 f 20,20,18 

280 OATA4Q,0,0,0,0,6,0,0,0,99S 

290 REH END OF PAGE 2 

300 DATA60,52,4B,40,34,36,42,60 

310 DATA60.52,4a,4B,40,34,36,42 

320 DATA54, 52, 42. 36.30,32, 38,54 

330 DATA54.52,42,36,30,30,32.38 

340 DATA4B„44,3a,32,32,27,27,2B 

350 0ATA4a.48.44,44,38,32.32.27 

360 0ATA36.36,36,36.52,52,52,64 

370 DATASB,80,BQ,54.42,48,40,44 

380 DATA6Q,57,4B,40,34,36,42,60 

390 DATA60.57,48,48.40,34.36,42 

400 DATA40,57,54.4B.60,64.42,52 

410 DATA76,72.80,52,42.44.54,54 

420 DATA40,42,52,B0,60.72,72,68 

430 DATA36,38,38.44,44.54,54,64 

440 REM END OF PAGE 1 

450 0ATA54,54.54,72,48,4B,48.64 

460 DATA3Q,28.27,27,27.38,24,24 

470 DATA80,57.4a,40.34.38.42,60 

480 DATA60,57,48,44,42,0.0.0.40 

490 REH END OF PAGE 2 



A:X=X+4:GQT015 

A:X=X+4:G0T035 

A»2:X=X+4:G0T055 

1 :X=X+4:G0T090 
P0KE1B526,9S:P0KE16527,143:H=USR(0):CLEAR 

20.19,17,17,17,17.17,15 

3 . 27 . 3 , 27 , , , 20 . 21 . 20 , 1 9 , 1 7 

40 ,38, 3 0,26, 26,1 a, 18, 14, 13 

21 ,27,27,28.27,26,24 

20,13.13,18,16,20,21 ,21 ,24,22,22,22,20 
,19,19,20,20,13,13.22,22,24.24,17.15,15 
,13,11 ,10,13.18,24 

,32, 32, 32. 32, 32, 32, 30. 27, 40, 33,38, 28. 2B. 26, 24, 24 
,20,19,17,17.17,17,17,15 
,30,27,27,24,22,32,32,24,22 
,30,24,22.20,14,14 
,16,20,22,26,27,27,27.30,24,18 
,19,22,26.27,27,27,34,28,26,22,22,22 
,42,42,42,44,54,88.68.6 8,88,48,52,44,40,34,34,36 



30,36,26,27,3 2,22,24,30.32,36,38,42,40,38 
28,28.36,3 2.27,27.27,24,21 
20,19,17,17.17,17,17,15,24,26,27,30,32,34,36,0 



52,48,48,40,34,36,42,42 












42,80,52,52.48,40,34,34,38 


36 


42 








54,52,52.42,36.30,32,38,30 












54,52.42,36.36,30,32,38 












28,34,46,44,44,38,38,32,32 


27 


28 


34 


34 




28.34,48,44,44,38,38,32,32 


27 


27 


28 


34 




64,64,68,68,66.68 












52,40,54,40.57.72,76,78.44 


52 


57 


64 


48 


40,54,57 


57, 4B, 48. 40 ,34,3 6,42,42 












42, 64. 68, 76, 76, 48, 36, 40, 40 












52,52.48,54,60,68 












76,76,72,72,60,52,42,44,44 


54 










68,57.57.40,42.52,52,60,60 


72 


68 


57 






64, 80,52, 52, 38, 36, 3B. 44, 54 


54 


84 


64 


60 


68,52,52 



5Q0 DATA8. 8,8,8 
S10 DATAB.8,4,4 
520 DATAB.a.B.B 
53 DATA8,a,8,8 
540 DATA8,B,B,4 
550 DATA4,4,4,4 
560 DATAB,B,8,B 
570 DATA4.4.4.4 
580 DATAB.B.S.B 
580 DATAB.8.4,4 
600 DATAS.B.a.B 
610 DATAB,8,8,8 
620 0ATA8,8,8.4 
630 DATAB.4,4,4 
640 REH END OF PATE 
650 0ATA4.4.8.8 
660 DATAB,8,4,4 
670 DATAB,B,8,8 
680 DATAB,8,8.8 



8,8.8,8,4 
8,8 ,4,4,B 



4,8.8,8,8 
4,4,4.4,8 

4,4,8,B,B 



.4.4.4,4 

.4.4,4,4 

4.4,4,4,8 



42.42,40,3 8,3 8,38,52,52,34,34,34,34,44.4 
24. 32, 21, 20, 19. 28. 42, 68, BB 
57, 4B, 48. 40. 34, 36, 42, 42 
0.0,0,0,0,0,0,0,0,0,0,0,0.0,899 

8,8,4,4 

8,8 .4,4,4,4,8 

8,8,8.4,4 

4,8,8.8 

4,4.4.4.4,8.8,4,4 

4,4,4.4.4,4^4,8.8 



,4,4,8,8.8,4,4,4,4,8.4.4 
,8,B,4,4 



,8.8,8,4,4,8 

,8,4,4,4,4,8,8,8 

,4,4,8,8,4,4,4,4,4,4,4,4 

,4.8,4,4,4,4,4.4.4,4 

.B,B,B,4,4 

, 8, 8, 4. 4, 8. 8. 8, 8, B, 4. 4, 8 



10 GOSUB 650 


: HEM 


20 DEFINT V, 


A. B. 


30 V1 = 64 : 


REH * 


40 Va = 65 : 


REH * 


50 EN = 66 : 


REM * 


60 TN = 32 : 


REH * 


70 TF = : 


REM * 


80 CT = 67 : 


REH * 


90 PT = 128 


: REH 


100 NN = EDO 


: REM 



« THE TUNING SECTION IS RETRIEVED FIRST 
C, 0, T, X, Y, P, N : REM » INTEGERS ALL 
VOICE ONE USES OUTPUT LOCATION 64 
VOICE TWO USES OUTPUT LOCATION 65 
ENVELOPE TRIGGER USES OUTPUT LOCATION 66 
TRIGGER TURNED ON WITH VALUE 32 
TRIGGER TURNED OFF WITH VALUE 
8255 PIA CONTROL REGISTER AT LOCATION 67 
* PORT OUTPUT ONLY DEFINED BY VALUE 128 
« NUMBER OF NOTES DEFINED BY VALUE 200 
110 DIM V1 12,500) : REM * ARRAY OF NOTES AND THEIR DURATIONS 
120 DIM V2C2,5D0) : REM * ARRAY OF NOTES AND THEIR DURATIONS 
130 X=1 : REM * TEMPORARY COUNTER ONLY 
140 READ V1(1,X) : REM * READ VOICE ONE 

READ V1[2,X] : REM * READ DURATION ONE 
IF V1 [2,XJ = THEN 170 ELSE X = X + 1 
: REM * TEMPORARY COUNTER ONLY 
READ V2(1,X) : REM * READ VOICE TWO 
READ V2[2,X) : REM * READ DURATION TWO 
IF V2C2.X] = THEN 210 ELSE X = X + 1 



150 

160 

170 X=1 

180 

190 

t.UO 

210 A=1 



GOTO 140 



GOTO 180 



: B=1 : C=1 : D=1 



X=1 : Y=1 : Q=0 : R=2 
220 OUT CT.PT : OUT V1 ,255 : OUT V2.255 
230 G = V1(R,X) : H = V2(R,Y] : GOSUB 330 : GOSUB 350 

IF G <= Q THEN 250 ELSE 270 

GOSUB 330 : G = V1CR.XJ 



TO 14 : NEXT 

: IF H <= Q THEN 290 ELSE 310 

: GOSUB 350 : H = V2(R,Y] 



240 G = G - A 

250 X = X + A 

260 GOTO 280 

270 FOR W = 1 

280 H = H - A 

290 Y = Y + A 

300 GOTO 320 

310 FOR W = 1 TO 14 : NEXT 

320 IF X > 200 THEN 210 ELSE 240 

330 IF VUA.X) = Q THEN 340 ELSE OUT EN,TN 

OUT V1,V1CA,X) : RETURN 
340 FOR W = 1 TO 2 : NEXT : RETURN 



OUT EN.TF 



Once the connections are made, run the 
following few lines, an envelope test: 



10 


OUT 67,128 


REM 


SET B255 PORT 


20 


A$=INKEY» 


REM 


SCAN KEYBOARD 


30 


IF A*="" THEN 20 


REM 


LOOP IF NO KEY 


40 


OUT 66,1 


REM 


ENVELOPE ON SHOT 


50 


OUT 66,0 


REM 


ENVELOPE OFF SHOT 


60 


GOTO 20 


HEM 


LOOP AS NEEDED 



The envelope should be triggered each time 
you touch a key on the TRS-80. If the envelope 
does not trigger, move the interface connection 
to the negative-going envelope, and try again. If 
the envelope is still not working, increase the 
values for C3 or R5, which are found at pins 14 
and 15 of Z8. This will lengthen the trigger 
cycle, and should handle any synthesizer input. 
Again, try both the positive and negative 
envelopes. 

Now disconnect the envelope trigger, and 
patch the envelope out of the synthesizer. Try 
the following program which creates a series of 
fast-rising whoops if the digital-to-analog 
converter is working properly: 



10 OUT 67,128 : REM 

20 INPUT'TIME DELAY" ;N : REM 

3D FOR X = TO 255 : REM 

40 OUT 64 ,X : REM 

50 FOR Y = 1 TO N : REM 

60 NEXT : NEXT : REM 

70 GOTO 20 : REM 



SET UP B255 PORT 
GET INTERNOTE DEWY 
SET TO RUN ALL NOTES 
SEND VOLTS TO SYNTHO 
SET UP TIMING LOOP 
TIME, GET NEXT NOTE 
BACK FOR NEXT DELAY 



Each time you run through the program to the 
INPUT statement, increase the value for the 
time delay; the whoops will slow until you can 
hear a series of discrete pitches. If you have a 
two-voice synthesizer (or to test the second voice 
of the interface), connect the voltage output from 
voice 2, and use OUT 71,128 to set the port and 
OUT 68,X for the data. 

If the pitches fall instead of rise, then your 
synthesizer responds to a higher voltage as a 
lower pitch, and any music routines you write 
will have to take this into account. If this is the 
case, before you run change line 60 to read: 

60 OUT 66,32 : OUT 66,0 : OUT 64,C255-MLH ,PH) ) 

Finally, run Listing 7-4, a rendition of 
keyboard prelude 23 from Johann Sebastian 
Bach's Well-Tempered Clavier. 



Listing Continued , 
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Continued Listing 



Continued Listing 



OUT EN.TF 



350 IF VaCA.YJ = O THEN 360 ELSE OUT EN.TN 

OUT V2,V2(C,Y) : RETURN 
360 FOR W = 1 TO 2 : NEXT : RETURN 

370 DATAB1, 4, 105, 2, 102, 2,87, 4, 114, 4, 102, 4, 120, 2. 117, 2, 132, 4, 126 
380 DATA4, 90, 4, 96, 6, 83, 2, 96, 4, 123, 2, 117, 2,1 23, 4, 132, 8, 138, 2, 111 
380 DATA2, 117 ,2, 132, 2, 129, 2, 132, 2,138, 4, 144, 2,135, 2, 138, 4,138, 4 
400 DATA108, 4, 123, 4, 87, 4, 117, 4, 93, 4, 96, 2, 90 ,2, 87, 2, 84, 2, 87, 12 
410 DATA108,4, 102,12, 132,4, 129, 4, 138, 4, 135. 4, 129, 4, 123 ,4,111 ,2 
420 DATA120,2, 123, 4, 87, 4, 108, 4, 75, 2.81 ,2, 87, 4, 108, 2, 105,2,108 
430 DATA2, 132, 2, 13B, 2, 123, 2, 126,4, 111 ,4. 96, 4, 99, 4.87, 4, 90, 8. 93 
440 DATA8, 102, 8, 105, 8, 108, 4, 132, 4, 93, 4,138, 4, 81 ,4,105,2.102,2 
450 DATA87, 4, 114, 4, 102,4, 120. 2, 117, 2, 132, 4, 126 ,4, 90 ,4, 87, 2, 90, 2 
460 DATA96, 2, 102, 2, 96, 2, 102, 2, 105, 2, 87, 2, 93, 2, 129. 2,132, 2,1 26, 2 
470 DATA123,2,126,2,120,2,117,2,111 ,2,105,2,162,2,111 ,2,108,2 
480 DATA111, 2, 120, 2, 117 ,2, 111, 4, 138, 2, 117, 2, 123 ,4, 121 ,2, 105, 2 
480 DATA132, 2,126 ,2,120,2,117,2,111 ,4,132,2,129,2,132,4,102,4 
500 DATA81, 4, 87, 2, 90, 2, 96, 2, 99, 2, 98, 2, 117, 2, 111, 2, 108, 2, 111 ,4 
510 DATA114,4,111 ,16,0,0,0,36,81 ,4,105,2,102,2,87.4,114,4,102 
520 DATA4, 120, 2, 117, 2, 132, 4, 126 ,4, 80, 4, 96, 6, 93, 2, 96, 4, 123, 2, 117 
530 DATA2, 123 ,4,132,8,138,2,111 ,2,117,2,132,2,129,2,132,2,138,4 
540 DATA144, 2,135, 2,138, 4,138, 4,108, 4, 123 ,4, 87, 4,117, 4, 83, 4, 96 
550 DATA2, 80, 2, 87, 2,84, 2, 87, 12, 108, 4,102, 12,132, 4, 123, 4.138, 4 
560 DATA135,4,128,4,123,4,111 ,2,120,2,123,4,87,4,105,4,75,2,81 
570 DATA2, 87, 4, 108, 2, 105, 2. 108, 2, 132, 2, 128, 2,123, 2, 126, 4, 111 ,4 
580 DATA96, 4, 99, 4,87, 4, 90 ,8, 93 ,8, 102, 8, 105, 8, 108, 4, 132, 4, 93, 4 
580 DATA138, 4, 81 ,4,105,2,102,2,87,4,114,4,102,4,120,2.117,2,132 
600 DATA4, 126 ,4, 90, 4,87, 2, 80,2.96,2, 102, 2, 96. 2, 102, 2, 106, 2, 87, 2 
610 0ATA93, 2, 128, 2, 132, 2,126, 2, 123, 2, 126 ,2, 120, 2, 117, 2, 111 ,2 
620 DATA105,2,102,2,111 ,2,108,2,111 ,2,120,2,117,2,111 ,4,138,2 
630 0ATA117,2,123,4,141 ,2,105.2,132,2,126,2,120,2,117,2,111 ,4 
640 DATA132,2,129,2,132,16,0,0 : REM * END OF TWO VOICES 
650 REM • THE TUNING SECTION PRODUCES OCTAVE PITCHES 
660 OUT 67,128 : REM * SET UP THE 8255 PIA FOR ACTION 
670 OUT 64,3 : OUT 65,3 : FOR N = 1 TO 1000 : NEXT 
680 OUT 64,39 : 0UT65,39 : FOR N = 1 TO 1000 : NEXT 
680 OUT 64,75 : OUT 65,75 : FOR N = 1 TO 1000 : NEXT 
700 OUT 64,111 : 0UT65,111 : FOR N = 1 TO 1000 : NEXT 
710 OUT 64,147 : OUT 65,147 : FOR N = 1 TO 1000 : NEXT 
720 A* = INKEY* : IF AS = »" THEN 670 ELSE RETURN 



10 CLE : PRINTCHR8I23] "- GENERALIZED MUSIC PROGRAM -" 
20 PRINT i PRINT : PRINT "DENNIS 8ATH0RY KITSZ, HAY 1979" 
30 FOR X = 1 TO 1000 : NEXT : CLEAR : CLS 

40 PRINT"THERE ARE 639 NOTES IN BACH PRELUDE NO. 23" : = 639 
50 GOTO 400 : REM • HOVE TO TUNING ROUTINE BEFORE PLAYING PIECE 
80 DIM HL(2,Q+5D] : REH * EXTRA BYTES SET ASIDE FOR LONGER WORK 
70 PRINT : PRINT"NOW READING" ;d; "NOTES FROM NOTE/RHYTHM DATA." 
80 FOR PH = 1 TO : REH * PH SPECIFIES PITCH S. DURATION ARRAY 
80 FOR NT = 1 TO 2 : REH • NT SPECIFIES THE TWO ARRAY ELEMENTS 
100 READ HL(NT,PH) : REH * EACH PITCH AND RHYTHH FILLS ARRAY 
110 NEXT NT.PH : REH * REAO ENTIRE ARRAY OF 639 NOTES S RHYTHMS 
120 INPUT "PRESS ENTER TO START PIECE":Z : REM • WAIT FOR START 
130 FOR PH = 1 TO a : REH * HEAD ARRAY LOOP TO PLAY BACK MUSIC 
140 OUT 66.32 : OUT 66,0 : REM * ENVELOPE TRIGGER ON THEN OFF 
160 OUT 64,ML(1,PHJ : REH • THEN SEND PITCH TO D/A CONVERTER 
160 FOR X = 1 TO ML(2,PH] : NEXT : REM • ARRAY DURATION DELAY 
170 NEXT PH : REM • AND CONTINUE UNTIL ALL NOTES ARE PLAYED OUT 
180 INPUT "PRESS ENTER TO PLAY AGAIN";Z : REH • OPTIONAL REPEAT 
190 GOTO 120 : REH • ANOTHER PIECE HAY BE ADDED AND RUN HERE 
200 DATA6B,31 ,80, 31, 117, 31. 90, 31, 66, 31. 90. 31, 111 , 31. 90, 31 .69, 

31, 80, 31. 117, 31, 90. 31, 54. 31, 102. 31, 126. 31, 102, 31 ,60, 31, 

81 , 31, 1 05 , 31, 81 ,31, 54, 31, B1, 31, 102, 31. 81, 31, 60, 31, 61 .31, 

105,31 ,81 ,31 ,45,31 ,90,31 .117.31 .90.31 
210 0ATA48,31 ,69, 31, 86, 31, 69, 31, 45. 31 ,69. 31, 90, 31. 69. 31. 48, 31, 

68, 31, 96, 31. 89, 31 ,33, 31, 81 ,31, 105, 31, 81 ,31, 39. 31. 61 ,31, 94. 

31, 81 ,31, 33, 31, 81, 31. 96, 31, 81, 31. 30, 31. 75, 31, 90, 31, 75, 31, 

18,31 ,66,31 ,64,31 ,66,31 
220 DATA69.31 ,81 ,31, 90, 31, 81 ,31, 54, 31. 69, 31, 81, 31, 69, 31, 45, 31. 

54,31,69,31,54,31,33,31 ,46,31 ,54,31 ,45,31.24,31,45,31 ,51 , 

31, 57, 31 ,60, 31, 66, 31, 69. 31 .75, 31, 69, 31, 60. 31, 66. 31, 69, 31, 

75,31 ,81 ,31 ,87.31 ,90,31 
230 DATA75.31 ,87, 31, 86, 31, 87, 31, 60, 31, 75, 31, 87, 31, 75, 31, 51 ,31, 

60. 31 ,75, 31 .60, 31 ,39, 31. 51 ,31, 60, 31. 51 ,31 .30. 31, 51 ,31, 54, 

31 ,60, 31, 66, 31, 72, 31, 75. 31, 81 .31, 75, 31, 66, 31. 72, 31, 75. 31. 

81 ,31 .87,31 ,98,31 .86.31 
240 DATA81 ,31 ,90 ,31 .102,31 ,90 ,31 ,66 ,31 .81 ,31 ,90 .31 ,81 ,31 ,54,31 , 

68,31 ,81 .31 ,66,31 ,45,31 ,54,31 ,66,31 ,54.31 ,33.31 ,54,31 ,81 , 

31, 54, 31, 24, 31, 54, 31 ,69, 31, 54, 31, 30, 31, 54, 31, 75, 31, 54, 31, 

18,31 ,54,31 ,84,31 ,54,31 
250 DATA33.31 ,54 ,31 ,81 ,31 , 54,31 , 24 ,31 , 54,31 ,69 ,31 ,54,31 .30 ,31 , 

54,31 ,75,31 .54,31 ,18,31 ,54,31 .84,31 .54,31 ,33,31 ,54,31 ,B1 , 

31, 54, 31 ,36. 31 ,60, 31, 90. 31, 60. 31, 3 9, 31, 60, 31. 87, 31, 60, 31, 

42,31 ,68,31 ,88,31 ,66,31 
26 0ATA45,31 ,66, 31. 90 ,31. 66. 31, 9. 31, 69, 31, 102, 31, 69, 31, 15, 31, 

69, 31, B6, 31, 68, 31, 51 ,31 ,75, 31, 105, 31. 75, 31, 54. 31, 75, 31, 

102,31 ,75,31 ,16,31 ,81 ,31 ,111 ,31 ,81 ,31 ,24,31 ,B1 ,31 ,105,31 , 

81 , 31 ,60, 31 ,87, 31, 117, 31, B7, 31 
270 DATA66,31 ,75,31 ,81 ,31 ,87 ,31 ,90 ,31 ,96 ,31 ,1 02 ,31 ,106 ,31 ,111 , 

31 ,105,31 ,102,31 ,96,31 ,90,31 ,84,31 ,81 ,31 ,75.31 ,61 .31 ,69, 

31 ,66, 31, 68, 31, 54, 31. 48. 31. 45, 31 ,39, 31, 33, 31, 39, 31, 45, 31, 

39, 31, 33, 31, 30, 31, 24. 31 ,1B, 31 
280 DATA15.31 ,75, 31 ,105, 31 ,75. 31, 18, 31, 75, 31, 102, 31, 75, 31. 9, 31, 

68, 31, 102, 31, 68, 31, 15, 31, 69. 31, 96. 31, 69. 31, 18, 31, 66. 31. 98, 

31 ,66, 31 ,30, 31, 66, 31, 90. 31, 66, 31, 33, 31 .60. 31. 90, 31. 60, 31. 

38,31 ,60,31 ,B7,31 ,60,31 
290 0ATA1B.31 ,75, 31, 90, 31 ,75, 31 ,66. 31, 90, 31 ,75, 31, 66. 31, 54, 31, 

68, 31 ,75, 31. 68, 3 1.54, 31. 75, 31 ,66, 31. 54, 31 .39, 31, 54, 31, 51, 

31, 45, 31, 38, 31 ,33, 31, 30, 31, 24, 31. 16, 31, 30, 31, 39. 31, 54, 35, 

66, 3 9, 75, 42, B4, 45, 93, 48 
300 DATA8 , 250 , 45 . 15, 54 , 15, 68, 15, 61,15. 99. 15, 105,15, 117, 15,1 26 , 



400 
410 
420 
430 
440 
450 
46 
470 
480 
480 
500 



200, 45, 15", 54, 15, 6 9, 15, 81 , 15, 9B, 15, 105, 15, 117, 15, 126, 50, 36, 

15, 45, 15, 80, 15, 86, 15,1 OB, 15, 11 7, 15, 126, 131, 132, 31, 13 5, 31, 
13 2,31,126,31 ,120,31,117,31,120.31 

DATA1 26,3 1,1 23,3 1,1 17,3 1,1 11 ,31,1 OB ,31, 111, 31 ,117, 31 ,111, 
31 ,108,31 ,102,31 ,96,31 ,102,31 ,108,31 ,102,31 ,96,31 ,80,31 , 
84,31 ,81 ,31 ,75,31 ,69,31 ,63,31 ,60,31 ,54,31 ,48,31 ,46,31 ,39, 
31 ,38,31 ,30,34,24,37,18,40,12,44,9,48,3,250 

DATA39, 15,48, 15,60, 15, 75, 15,96, 15,1 11 ,15,120,200,39,15,48, 
15, 60, 18, 75, 15, 96, 15, 105, 15, 111, 15, 120, 60, 54, 15, 66, 15, 75, 
15,90,15,102,15,111 ,15,120,131 ,54,31 ,38,31 ,45,31 ,48,31 ,54, 
31 ,60,31 ,68,31 ,69,31 

DATA66, 31 ,60, 31, 54, 31 ,60, 31 ,66, 31, 88, 31 ,75, 31 ,81 ,31 ,75, 31, 
68,31 .66,31 ,68,31 ,75,31 ,81 ,31 ,84,31 ,80,31 ,84,31 ,81 ,31 ,7 5, 
31,81 ,31,84,31,80,31,86,31,102,31,105,31,111 ,31,117,31, 
120,34,126,37,132,40,138,44,128,46 

DATA141 ,250,33,15,45,15,54,15,69,15,80,15,102,15,105,15, 
117,200,33,15,45,15,54,15,68,15,80,15,102,16,106,15,117, 
50, 48, 18, 60, 15, 68, 15, 84, 15, 96, 15, 105, 15, 117, 260, 51, 15, 60, 
15,68,15,86,15,106,15,114,200,51 ,15,60,16,75,15,88,15,105 

DATA15,111 ,50,54,15,68,15,75,15,84,15,80,15,102,15,111 ,250, 
102,15,111 ,31,102,31,90,31,84,31,90,31 ,102,31,111,31,102, 
31,111 ,31,102,31,80,31,84,31,80,31,102,31,111 ,31,129,31 , 
126, 31, 120, 31, 114, 31 ,111, 31, 105,3 1,1 02, 31, 96 ,31 

DATA1 02,31 ,90,31 ,102,31 ,111 ,31 ,120,31,128,31 ,138,31 ,147,31 , 
141 ,B3,1 11 ,31 ,114,31 ,102,31 ,106,31 ,87,31 ,16,1 5,38,18,48, 
15, 54, 15. 75, 15, 80, 15, 105, 15, 111, 125, 81 ,126, 16, 15, 39, 16, 48, 
1 5, 54,1 5, B4, 15,80, 15, 102, 11 6.1 11 ,031,54,125,60,125 

0ATA33,15,45,15,54,15,63,15,81 ,15,80 ,15, 105, 250, B1 ,31 ,80, 
31 ,81 ,31 ,88,31 ,86,31 ,69,31 ,81 ,31 ,80,31 ,B1 ,31 ,80,31,81 ,31, 
68,31 ,68,31 ,69,3.1 ,81 ,31,90,31,108,31,99,31,80,31,81,31,72, 
31 ,66,31 ,54,31 ,81 .31 

DATA60,15,84,15,B1 ,15, 64, 15, 81 ,16, 84, 125,81 ,31 .76, 31 ,81 ,31, 
84. 31,61 ,31 ,75, 31 ,68, 31 ,66 ,31 ,69, 31 ,75, 31 ,89, 31 ,66, 31 ,80, 
31 ,54,31 ,60,31 ,66,31 ,60.31 ,54,31 ,4B, 31 ,45,31 ,48,31 ,54,31 , 
48.31 ,45,31 ,3 9,31 ,33,31 ,3 0,31 

DATA33.31 ,45,31 ,54,31 ,45,31 ,45 ,31 ,54,31 ,69,31 ,54,31 ,54,31 , 
69,31 ,B1 ,31 ,69,31 ,69,31 ,81 ,31 ,80,31 ,81 ,31 ,81 ,31 ,90,31 ,105, 
31 ,90,31 ,80,31 ,105,31 ,117,33,105,35,105,37,117,39,126,42, 
117,45,141.150 

REH «»«.»««•» TUNING SECTION FOLLOWS •••••••• 

PRINT"THIS IS THE TUNING SECTION — OUTPUT IS 3, 39, 75." 

PRINT"HOLD SPACE BAR TO BEGIN READING BACH PRELUDE DATA." 

OUT 64,3 ! FOR X = 1 TO 500 : NEXT : REM • OUTPUT LOW C 

OUT 64,38 : FOR X = 1 TO 500 : NEXT : REM * NEXT OCTAVE 

OUT 64.75 : 

OUT 64.111 i 

OUT 64,147 

AS = INKEYS 

OUT 68,255 



FOR X = 1 TO 500 
FOR X = 1 TO 500 
FOR X = 1 TO 500 

: IF A 
REH 



NEXT : 
: NEXT 



REM * 
: REM 



NEXT OCTAVE 
NEXT OCTAVE 
NEXT : HEM * TOP OCTAVE 
S = "" THEN 480 ! REM • CHECK KEYBOARD 
HOPE THAT VERY TOP NOTE IS INAUDIBLE 



GOTO 60 : REM » NOW RETURN TO MAIN MUSIC READING ROUTINE 



Listing 7-4. Johann Sebastion Bach. 
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SIGNAL 




P/N 


NAME 


DESCRIPTION 


1 


RAS* 


Row Address Strobe Output for 16-Pin Dynamic Rams 


2 


SYSRES* 


System Reset Output, Low During Power Up Initialize or 

Reset Depressed 
Column Address Strobe Output for 16-Pin Dynamic Rams 


3 


CAS* 


4 


A10 


Address Output 


5 


A12 


Address Output 


6 


A13 


Address Output 


7 


A15 


Address Output 


8 


GND 


Signal Ground 
Address Output 


9 


All 


10 


A14 


Address Output 


11 


A8 


Address Output 

Peripheral Write Strobe Output 


12 


OUT* 


13 


WR* 


Memory Write Strobe Output 


14 


INTAK* 


Interrupt Acknowledge Output 


15 


RD* 


Memory Read Strobe Output 


16 


MUX 


Multiplexor Control Output for 16-Pin Dynamic Rams 


17 


A9 


Address Output 
Bidirectional Data Bus 


18 


D4 


19 


IN* 


Peripheral Read Strobe Output 


20 


D7 


Bidirectional Data Bus 


21 


INT* 


Interrupt Input (Maskable) 
Bidirectional Data Bus 


22 


Dl 


23 


TEST* 


A Logic "0" on TEST* Input Tri-States A0-A15, D0-D7, 
WR*, RD*. EN*, OUT*, RAS*. CAS*, MUX* 


24 


D6 


Bidirectional Data Bus 


25 


At 


Address Output 
Bidirectional Data Bus 


26 


D3 


27 


Al 


Address Output 
Bidirectional Data Bus 


28 


D5 


29 


GND 


Signal Ground 


30 


D0 


Bidirectional Data Bus 


31 


A4 


Address Bus 


32 


D2 


Bidirectional Data Bus 


33 


WAIT* 


Processor Wait Input, to Allow for Slow Memory 


34 


A3 


Address Output 


35 


A5 


Address Output 


36 


A7 


Address Output 


37 


GND 


Signal Ground 
Address Output 


38 


A6 


39 


GND 


Signal Ground 


40 


A2 


Address Output 


NOTE: *meansl 


Negative (Logical "0") True Input or Output 



13 15 17 19 21 23 25 



27 29 31 33 35 37 39 

i— ■ i— ■ 1=1 a a C3 ex. 



8 10 12 14 



-a — □ — a — a — □ — a~ 

20 22 24 26 28 30 



-a — □ — a — cr- 

34 36 38 40 



Mates with AMP P/N 88103-1 Card 
Edge Connector or Equivalent 



Figure 8-1. TRS-80 edge card connector. 



Adding to the System 

In this Chapter we will explore several 
hardware projects to expand the TRS-80's 
capabilities : 

A parallel printer interface for keyboard 
units without an expansion interface. 

An expansion of system RAM and ROM in a 
'reserved' block in the memory map. 

Bank selection of RAM and ROM in that 
'reserved' blank area, and a memory 
expansion that includes bank selected RAM. 

A programmable input/output port device 
and a companion interrupt I/O board. 

Battery backup and real time clock. 

Parallel Printer Interface 

Perhaps the simplest addition to the keyboard 
unit is a printer interface. Radio Shack sells a 
complete cable for this purpose, but building one 
is both less expensive and more enlightening. 

When an LLIST or LPRINT command is 
entered, the computer enters a subroutine which 
plucks each character to be printed, checks its 
value, and converts it if necessary. Line feeds, for 
example, are converted to carriage returns, and 
form feeds are converted to the proper number of 
line feeds according to the value in the printer's 
device control block. 

The final value is written to an address, 
almost exactly as if it were being stored in 
memory. The hardware decodes that memory 
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Parallel Printer Interface 



address and sends the character along parallel 
data lines to the printer. The printer then sends 
a 'busy' signal to the memory address. The 
LPRINT or LLIST routines read this busy 
signal, wasting time until the printer is ready. 
When the busy signal turns off, the next 
character is plucked, converted and sent to the 
printer. The process continues until all 
characters are printed. 

There are disadvantages to this system; 
among them the fact that the printing process 
'hangs up' the computer for the duration. This 



can easily be avoided in an interrupt-driven 
system (see Supplement to Chapter 5), and even 
modified in a less successful way as a 
background routine to the keyboard scan. But 
the overall process is simple, requiring neither 
sophisticated hardware nor complex software. 

Figure 8-1 presents the complete circuit for a 
printer interface board. It consists of three 
sections : 

1. An address decoder for 37E8, the printer 
location. 




IC 


TYPt 


+5V 


gnd| 


21 


74LS30 


14 


7 


12 


74LS2S0 


14 


7 


23 


74LS00 


14 


7 


24 


74LS123 


16 


8 


25 


74LS377 


16 


8 


Z6 


74LS367 


16 


8 



Figure 8-2. Parallel printer interface. 
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2. An 8-bit output buffer for sending 
characters to the printer. 

3. An input buffer for checking the status of 
the printer (busy or out of paper). 

The address decoder is formed by Z 1 and 
Z 2 evaluating the address lines in conjunction 
with RD (read) or WR (write) signals from the 
computer. If WR is sent, buffer Z 6 is 
activated, sending a character to the printer. If 
RD is sent, buffer Z 6 is activated, sending the 
status of the printer to the CPU. 

Power-up the TRS-80, and go through the 
input sequence. If this process does not act 
normally, turn the computer off immediately 
and recheck the wiring. If all is normal, it's time 
for a printer test. Turn the printer on (don't be 
surprised by a return to MEMORY SIZE? if your 
printer is an older, electrically noisy one). The 
simplest way to test the printer interface is to 
load any program and LLIST it. The printer 
should spring to life, printing a complete list. If 
there are problems, they will probably be among 
the following : 

No characters printed at all; computer 
immediately (or after a short pause) returns to 
ready. 

Characters are being sent to the memory 
address, but not being received by the printer. 
Therefore, no 'busy' is being received, and the 
computer dumps all its characters as fast as it 
can. 

Solution : check wiring of the port address, 
wiring to the output buffer select line, and see 
that the board has both power and ground 
wires connected. 

No characters printed at all; computer 
immediately locks up : 

Characters are being sent to the memory 
address, but if none are printed, they are not 
being received by the printer. The computer is 
seeing a constant 'busy' signal, and thus is 
waiting in a loop. 

Solution : check wiring of the port address, 
wiring to the input buffer from the printer, 
and see that the printer is enabled (if it has an 
enable function). 

Intermittent but regular characters (every 
third or fifth or fiftieth character, for example) 
are being printed. 

Characters are being sent through to the 



printer, but no handshake ('busy') is being 

received by the computer. 

Solution : check wiring of the input buffer 
select line, and the wiring from the printer's 
• busy signal. Some printers may not have a 
busy signal; see box for suggestions.. 

A single character is printed, then printing 
stops and the computer locks up. 

A constant busy is being received by the 
computer, and it is waiting in a loop for the busy 
signal to terminate. 

Solution : check for ground shorts in the 
printer's busy line, or shorts to ground at the 
input buffer. 

Incorrect characters are printed, and none or 
any of the above symptoms are present. 

The data lines are incorrectly wired to the 
printer or to the board's output buffer. The 
printer may be wired for complement ASCII. 

Solution : check the wiring of the data lines 
for reversed wires, either at the computer or 
printer end. If all is well, enter the following 
short program : 

10 FOR X = 65 TO 91 
20 Y = NOT X AND 255 
30 POKE 14312, Y 
40 FOB N = 1 TO 100 
50 NEXT : NEXT 

Listing 8-1. Printer interface test routine. 

This program produces the complement of the 
letters from A to Z. If the correct letters are 
printed this time, replace Z 5 with an inverting 
buffer, type 81LS96. 

Talking with the World - 
The Computer as Boss 

The TRS-80 has remarkable skills for 
controlling the world around it. Four BASIC 
commands (POKE, PEEK, INP, and OUT) and 
their machine language equivalents (LD register, 
LD memory, IN register, OUT port) are the 
software conversational tools by which the 
computer makes its wishes known. 

Only one dilemma remains: very little 
hardware was provided with the TRS-80 to use 
these powerful features. Just a single port (255) 
was hard-wired in place, and it is limited to 
controlling cassette functions and video display 
size. Memory mapped input/output was left 
exclusively to the expansion interface. And even 
then then, only for a printer, dual cassette, 
RS-232 and disks. In each case, no uncommitted 
user ports or memory addresses were provided. 
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Fortunately, creating such input/output (I/O) 
is not difficult. There are two very effective ways 
to accomplish it: 

1. Using inexpensive, separate logic devices 
that can be dedicated to their interfacing 
tasks. The TRS-80 Technical Reference 
Handbook describes such simple hardware in 
its 'coffee pot' scenario. 

2. Using more costly programmable 
interface devices (such as the INS8255 
peripheral interface adaptor) for handling 
more flexible, general purpose I/O. 

In either case, the input/output device must be 
identifiable by the computer, which means it 
must somehow be located. It is assigned a port 
number or a memory address. But what does this 
number mean, and how does it work? I have often 
used the analogy of the key in the lock, because it 
so well describes the way the electronics can open 
the doors to the world outside its case. 

Figure 8-3 shows a simple-minded lock and 
key. It is simple minded because there are no fine 
graduations in the height of the tumblers - the 
'pins' either rise to a single height, or are not 
present at all. In the computer, these pins are 
really voltages, represented by numbers. 



In other words, the higher voltage can be called 
a 'one', and the lower voltage can be considered a 
'zero'. In this way, the key number code shown in 
Figure 8-3 might look like this : 



ON ON OFF ON 
110 1 



OFF OFF OFF 




The sample key's code (binary 1101 1000) 
works out to the hexadecimal value D8, or the 
decimal equivalent 216 (refer to Chapter 2 for 
details on binary, decimal, and hexadecimal 
numbers). The 'key' is the value that the 
computer will output; the 'tumblers' are the 
hardware which will unlock when this key is 
inserted. 

Below is the schematic of a general purpose 
'tumbler' which can be adjusted to open to any 
electronic key. As noted in Chapter 2, the 
triangles are buffers which protect the TRS-80 
electronic hardware from overexertion. Once 
again, the triangle with the 'not' circle at its point 
is an inverting buffer, which reverses the value of 
any signal placed at its input. 





Figure 8-3. Lock-and-key illustration. 



Figure 8-4. Unconnected buffer diagram. 
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This is very elementary - it will be improved on 
later - but it is the central scheme of digital 
operation. Real tumblers must all be lifted to a 
point so they are in line with the edge of the lock's 
cylinder. Electronically, the same thing must 
take place. To turn the electronic cylinder, all 
the binary input values must be lifted (or 
depressed) to the same value before the 
electronic lock will click open. 



UBing Exctusive-OR for decoding 



Resistor 1K ohms to 


Ground; Switch 


to Plus Volte 


Switch Position 


Input Vetue 



1 
1 


Output Velue 


OFF (gate sees 0) 
ON Cgate sees 1] 
OFF Cgete sees 0] 
ON (gate sees 1) 



1 
1 



Resistor 1K ohms to 


PLUS Volts; Switch to Ground 


Switch Position 


Input Value 



1 
1 


Output Velue 


OFF (gate sees 1) 
ON (gate sees 0} 
OFF (gate sees 1] 
ON (gats sees 0) 


1 


1 



$##*$$$3j}($$$$$$$9$$*$*$*$«i*$$*$e**a*«***«$**********$9****** 



Table 8-1. Using exclusive-OR for decoding. 
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Figure 8-6. Improved port decoding for port addresses. 



Figure 8-5 is the schematic for an elementary 
interface circuit. Zl and Z2 form the tumblers, 
and Z3 is the cylinder. 

There is another way to produce the same 
effect as Zl and Z2, and no rewiring or jumpering 
is necessary. To do it, you can use one or two 
74LS86 exclusive OR gates. Exclusive OR is a 
remarkable electronic function which states : 

7/ two input signals are alike, the evaluated 
result will be set to zero. If two input signals 
are different, the evaluated output will be set 
to one. 

Here's how that might work electronically. 
One input of an exclusive OR gate is attached to 
a switch and a resistor. The resistor is attached 
to ground, with the switch connected to the 
positive voltage line. When the switch is off, the 
input looks like a zero. When the switch is on, the 
lower resistance of the switch makes the input of 
the gate see a one. 

Therefore, with the switch off, a signal coming 
into the second input of the gate would cause a 
one output when it is a one. With the switch on, 
a signal coming into the second input of the gate 
would cause a zero output when it is a one. Refer 
to Table 8-1. 

By using eight exclusive OR gates (two type 
74LS86 circuits) and an 8 position DIP (dual 
inline package) switch, any one of the 256 
possible ports can be selected. The circuit below 
(Figure 8- 6 ) shows how Zl and Z2 in Figure 
8- 5 can be replaced with a switch and the 
74LS86's to select the port. Thus, jumpering and 
soldering from the original Zl and Z2 can be 
avoided. 

Now, before putting these ports to use, it's 
time to turn to the other type of input/output 
device - the programmable interface adaptor. 
The previous I/O device costs perhaps $5 to 
create. The central integrated circuit to the 
programmable I/O port itself costs about $8, but 
it offers some extra features and easier wiring. 

The INS8255 is a single integrated circuit 
capable of providing three complete 
input/output ports. Each port can act as an input 
or output, and that condition can be changed via 
programming. This is how it is done: using a 
decoder similar to that designed above, a 'chip 
select' is formed. 

When the 8255 receives the chip select, it 
examines its two address line connections. Two 
address lines can be configured four ways (00, 01, 
10, 11), and so can select one of the three I/O 
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Figure 8-5. Elementary interface. 
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Figure 8-7. 8255 configuration (control). 
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Figure 8-8. 8255 configuration (data). 
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ports, or - and this is the remarkable part - the 
8255's internal control register. The 8255 is a 
smart chip! 

When the control register has been selected, 
the 8255 can be programmed - its ports may be 
defined as input or output, and other 
combinations of actions can be selected. The 
various possibilities are shown in Figure 8-7 
and 8-8. 



Three Real-Time Clock/Calendars 

Telling the time and date is a legitimate 
concern of computer users, not only for keeping 
documents in order, but also for observing and 
controlling experiments. Until recently, the 
only type of real-time clock available was the 
one built into the expansion interface, which 
disk and Level HI users could access with the 
TME$ command. 

The principle of that clock is simple: forty 
times each second, a pulse is sent from the 
expansion box to the TRS-80 keyboard unit, 
where it is applied to the interrupt (INT) line. 
The computer responds by temporarily setting 
aside its other processing activities in order to 
update the seconds, minutes, and hours. When 
the user asks for the TIME$, the computer 
checks the area of memory in which this updated 
information is stored, and sends it to the current 
display device. 

The clocks presented in this section all use the 
TIME$ function, but avoid certain problems 
associated with the expansion box TIME$ 
function. First and foremost, it eliminates the 
need for the expansion box itself, and the special 
software to use the 25-millisecond interrupt. 

Without disk, this special software must be 
loaded for every session, reloaded if an 
inadvertent reset should occur, updated should 
the computer be turned off, and disabled at every 
CLOAD and CSAVE. Though convenient in a 
disk system, this type of approach is more of an 
annoyance in a Level II system. 

There are, however, two distinct advantages 
to an interrupt-based system for timekeeping: 
the hardware is simple and cheap to create, and 
in certain ways the clock pulses generated by the 
power line are more accurate than crystal- 
controlled clocks. The power line, because it is 
linked into a large network of generating 
systems, must maintain a virtually absolute 
synchronization over the long term. Short 
duration lags and leads in the 60-cycle pulses 
may appear, but the percentage of error over 
weeks, months, and years is virtually nil. 

Time updating from a simple pulse train can 
be complicated, too, because seconds, minutes 
and hours, days, weeks, months and years aren't 
very 'decimal' in their counting. 59 seconds plus 
one second is one hour and zero seconds. 23 
hours and one hour is one day and zero hours. 
You get the idea. So the software to update a 
pulse-based calendar needs special math, 
charts, and tables to keep the time and date in 
its electronic mind. 
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7F19 0D407F 
7F1C 47 
7F1D AF 
7F1E 04 
7F1F 05 
7F20 2805 
7F22 C616 
7F24 27 
7F25 18FB 
7F27 47 
7F28 79 
7F29 FEOA 
7F2B 3804 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
002S0 
00270 
002B0 
00290 
00300 
00310 
00320 
00330 
00340 
00350 
00360 
00370 
00380 
00390 
00400 
00410 
00420 
00430 
00440 
00450 
0046 
00470 
00480 
00490 
00500 
00510 
00520 
00530 
00540 
00550 
00560 
00570 
00580 
00590 
00600 
0OB10 
00620 
00630 
00640 
00650 
00660 
06 70 
006B0 
00690 
00700 
00710 
00720 
00730 
00740 
00750 
00760 
07 70 
00780 
00790 
00800 
00810 
00820 
00B30 
00B40 
00850 
00860 
00870 



tttt*tttttltl*ltt*tttlttttttttitt*tHttttt ############# 

THIS ROUTINE WILL USE THE ONE-SECOND INTERRUPT CREATED 
BY A HARDWARE ADDITION TO 00 TIMEKEEPING. THIS IS 
TRANSPARENT TO BASIC. NOTE THAT THIS IS NOT INCLUDED 
IN THE SLASH [/) FUNCTIONS CALLED BY THE CUSTOM 
INTERPRETER, AND THUS RETURNS ON ITS OWN TO BASIC ROM. 
tttttttttttttttttftltttttlttlttttttttiitntttttmttttt 



ORG 



7EC0H 



CHANGE TO RELOCATE 



ftttltttttttttttitttHtttHttilHtttHtHHtttHittHtt 

PATCH INTO DOS TIMES ERROR LOCATION AND CHANGE IT 
ttfttltttttt*ttHttt*lttiHtHtltlltltttttHttttttHtit 



DI 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
LD 
IM 
EI 
JP 



HL.START1 
C4177H) ,HL 
HL.START2 
(4174HJ ,HL 
A.0C3H 
(4012HJ .A 
HL, SERVE 
(4013H) ,HL 
1 

06CCH 



DISABLE ACTIVE INTRPTS. 
ENTRY OF TIMES PROGRAM 
REPLACE ?L3 ERROR MSG. 
START OF "CMD" PROGRAM 
REPLACE ?L3 ERROR MSG. 
GET "JUMP" COMMAND 
INSERT INT. PATCH POINT 
INTERRUPT SERV. ROUTINE 
INT. PATCH FROM 0038H 
SET INTERRUPT MODE #1 
ENABLE INTERRUPT LINE 
RETURN TO BASIC "READY" 



PATCH TO INTERCEPT ?L3 ERROR AND CHECK LINE'S SYNTAX 

######«####«############«###### ttttttttnttitttttttt 



RST 

PUSH 

LD 

CALL 

LD 

LD 

CALL 

LD 

INC 

DEC 

CALL 

LD 

INC 

DEC 

CALL 

LD 

INC 

LD 

CALL 

LD 

INC 

DEC 

CALL 

LD 

INC 

LD 

CALL 

JP 



10H 

HL 

A.11H 

2857H 

HL,(40D4HJ 

DE.SEC0ND+2 

DISPLY 

(HL) ,3AH 

HL 

OE 

DISPLY 

(HLJ ,3AH 

HL 

DE 

DISPLY 

{HLJ ,20H 

HL 

DE.SEC0ND+4 

DISPLY 

(HL) ,2FH 

HL 

DE 

DISPLY 

(HLJ ,2FH 

HL 

DE.SECOND+5 

DISPLY 

2884H 



HOUSEKEEP SPACE. ETC. 
SAVE BASIC LINE POINTER 
LENGTH OF TIMES ITSELF 
ROM STRING SPACE SETUP 
LOCATION TO FIND TIMES 
POINT DE TO HOURS POS'N 
CONVERT, PLACE IN TIMES 
PUT COLON INTO TIMES 
BUMP TIMES POINTER 
SET DE TO MINS. POS'N 
CONVERT, PLACE IN TIMES 
PUT COLON INTO TIMES 
BUMP TIMES POINTER 
SET DE TO SECS. POS'N 
CONVERT. PLACE IN TIMES 
PUT SPACE INTO TIMES 
BUMP TIMES POINTER 
POINT DE TO MON. POS'N 
CONVERT, PLACE IN TIMES 
PUT SLASH INTO TIMES 
BUMP TIMES POINTER 
SET DE TO DAYS POS'N 
CONVERT. PLACE IN TIMES 
PUT SLASH INTO TIMES 
BUMP TIMES POINTER 
POINT DE TO YEARS POS'N 
CONVERT, PLACE IN TIMES 
FINISH DISPLAY IN ROM 



: fttttttttHtHttHttHttllttttllttHttlttlitlttlttttttt 

; FIND VALUES IN TIME LOCATIONS AND CONVERT TO ASCII 

i HittttttttttttttttttHtHHtttttttttnttitttttttttttH 



DISPLY 



LD 

CALL 

LD 

XOR 

INC 

DEC 

JR 

ADD 

DA A 

JR 

LD 

LD 

CP 

JR 



A,tDE) 
NIBBLE 
B,A 
A 



Z, LEAVE 
A.16H 

LOOP 

B,A 

A.C 

OAH 

C, CLEAN 



GET VALUE INTO ACCUM. 
SEPARATE INTO 4 BITS 
VALUE INTO B FOR TEST 
CLEAR A FOR USE IN LOOP 
DUMMY INCREMENT ... 
DECREMENT TO TEST FOR 
UPPER NIBBLE NOW AT 
A=A+16 ...HEX-DEC CONV. 
DEC. ADJ. : 16 BECOMES 10 
LOOP TILL CONV. DONE 
SAVE VALUE BACK IN B 
SET LOW NIBBLE BACK 
IS IT GREATER THAN 10? 
NO WORK IF LESS THAN 10 



Listing 8-2. Interrupt-driven RTC (one second). 



Figure 8-9 is a one-pulse-per-second clock 
that triggers the keyboard unit's interrupt line. 
Because this clock and the expansion box would 
compete for that line, this circuit cannot be used 
in a complete TRS-80 system. But it is a $5 
project, and an inexpensive clock add-on for 16K 
systems alone. 

It consists of five integrated circuits. One 
regulates the voltage, the second (Z2) takes the 
sine-wave-shaped signals from the 6.3-volt 
power transformer and converts them to a sharp- 
edged digital signal. Z3 and Z4 divide the 60 Hz 
signal into a one-pulse-per-second signal. 
Finally, Z5 provides the 1 Hz interrupt signal. 

When the interrupting signal is accepted by 
the TRS-80, an 'interrupt acknowledge' signal is 
sent back to Z5. There is an important purpose 
to this action; it turns the interrupt signal off. 
Why? When the computer receives the interrupt, 
it sets aside its present software activities to 
'service' the interrupt. Unless the interrupting 
flip-flop is reset, the computer, upon completing 
the interrupt service routine, will think the 
previous interrupt is a new interrupt, and it will 
keep updating the time and date. 

Software to run this clock is presented in 
Listing 8-2. It patches into the TIME$ and 
CMD locations, and accepts time and date in the 
following format (use spaces and punctuation 
exactly as shown) : 

CMD"D9:15:22 05/1B/B1" 

The program checks for correct syntax of the 
set-time command line, but doesn't verify actual 
times or dates. So, until the clock is next 
updated, it will display whatever bizarre time 
and date you may have set it to! 

To print the time and date, enter PRINT 
TIME$. You may use TIME$ just as you would 
any other strings, including with PRINT, 
LPRINT, MID$, LEFT$, RIGHT$, 
concatenation, and other string manipulation. A 
complete description of these programs is in the 
supplement to this chapter. 
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7F2D 


060A 


008 80 




SUB 


OAH ; 


REDUCE IT TO THRU 5 


7F2F 


G610 


008 90 




ADO 


A.10H : 


NOW ADD CARRY BIT 


7F31 


BO 


00900 


CLEAN 


ADD 


A,B ; 


CREATE A DECIMAL RESULT 


7F32 


27 


00910 




DA A 




DEC. ADJ. THE TOTAL 


7F33 


C0407F 


00920 




CALL 


NIBBLE : 


SEPARATE INTO 4 BITS 


7F36 


C630 


00830 




ADD 


A.30H i 


CONVERT NIBBLE TO ASCII 


7F3B 


77 


00940 




LD 


(HLJ.A ; 


PLACE! VALUE INTO TIMES 


7F39 


23 


009S0 




INC 


HL ; 


BUMP 'TIMES PTR. BY ONE 


7F3A 


79 


00960 




LD 


A,C J ; 


SET VALUE SAVED IN C 


7F3B 


CB30 


00970 




ADD, 


* A.30H ; 


CONVERT NIBBLE TO ASCII 


7F3D 


77 


009 SO 




LD 


(HLJ.A 


PLACE VALUE INTO TIMES 


7F3E 


23 


008 80 




INC 


HL ; 


BUMP TIMES PTR. BY ONE 


7F3F 


C9 


01000 
01010 




RET 




BACK TO DO PUNCTUATION 






01020 


; ttttStimtttttin'itttlfitltlftS 


ttttitmntttntitttttt 






01030 


; SUBROUTINE TO CONVERT A BYTE AND SAVE IT AS TWO NIBBLES 






01040 


: ttttlHttttttlttltt*tHtttttt*t*tfHtHlttt*tttlttttttt 






01OB0 










7F40 


F5 


01080 


NIBBLE 


PUSH 


AF : 


SAVE THE BYTE BRIEFLY 


7F41 


E60F 


01070 




AND 


OFH ; 


MASK OUT THE HIGH BITS 


7F43 


4F 


01080 




LD 


C,A : 


SAVE LOW NIBBLE IN C 


7F44 


F1 


01090 




POP 


AF 


GET THE WHOLE BYTE BACK 


7F45 


1F 


01100 




RRA 




MOVE THE BYTE RIGHT.. . 


7F46 


1F 


01110 




RRA 




. . . TWO PLACES .. . 


7F47 


1F 


01120 




RRA 




. . . THREE PLACES . . . 


7F4B 


1F 


01130 




RRA 




UNTIL MSB BECOMES LSB 


7F49 


E60F 


01140 




AND 


OFH 


MASK OUT THE HIGH BITS 


7F4B 


09 


011B0 
01160 




RET 




NIBBLES NOW IN A a C 






01170 


i ############*#«##«##ss######s 


ItttHHtttttttHHttttt 






01180 


; INTERRUPT SERVICE ROUTINE IS ENTERED AT 1 -S CLOCK PULSE 






01190 


: ########### tttltttttltttltttltt 


tttttttiUMtttitttttttt 






01200 










4041 




01210 


SECOND 


EQU 


40 41 H 


LOCATION TO STORE TIMES 


7F40 


F3 


01220 


SERVE 


01 




DON'T BOTHER ME NOWI 


7F4D 


FB 


01230 




PUSH 


AF 


SAVE ACCUM. S FLAGS 


7F4E 


E5 


01240 




PUSH 


HL 


SAVE HL REGISTER PAIR 


7F4F 


DS 


012B0 




PUSH 


DE 


SAVE OE REGISTER PAIR 


7F5D 


3A4B40 


01280 




LD 


A,(SED0ND+4] 


GET CURRENT MONTH VALUE 


7F53 


BF 


01270 




LD 


E,A 


SAVE MONTH VALUE IN E 


7FB4 


1B0B 


012B0 




LD 


0,0 


LET 0=0. REASON FOLLOWS 


7F56 


214148 


01290 




LD 


HL, SECOND 


START AT SECONDS POS'N. 


7FB9 


34 


01300 




INC 


(HLJ 


SECONDS = SECONDS + 1 


7F5A 


7E 


01310 




LD 


A,(HLJ 


GET READY TO COMPARE 


7F5B 


FE3C 


01320 




CP 


60D 


IS IT 60 SECONDS? 


7FSD 


3B24 


01330 




JR 


C.OUT 


DONE IF NOT 60 SECONDS 


7F5F 


CD8 87F 


01340 




CALL 


TICTOC 


ADVANCE TIME SUBROUTINE 


7F62 


FE3C 


013S0 




CP 


600 


IS IT 60 MINUTES? 


7FB4 


381D 


01360 




JR 


C.OUT 


DONE IF NOT 60 MINUTES 


7FBB 


CD897F 


01370 




CALL 


TICTOC 


ADVANCE TIME SUBROUTINE 


7FB3 


FE1B 


013B0 




CP 


240 


IS IT 24 HOURS? 


7FBB 


381B 


01390 




JR 


C.OUT 


DONE IF NOT 24 HOURS 


7F6D 


CD897F 


01400 




CALL 


TICTOC 


ADVANCE TIME SUBROUTINE 


7F70 


EB 


01410 




PUSH 


HL 


SAVE REGISTER BRIEFLY 


7F71 


21937F 


01420 




LD 


HL. LOOKUP 


DAYS-IN-MONTH TABLE 


7F74 


19 


01430 




ADD 


HL.DE 


REMEMBER DE? SEE ABOVE 


7F75 


BE 


01440 




CP 


(HLJ 


IS IT LAST DAY OF MONTH 


7F76 


E1 


01450 




POP 


HL 


GET REGISTER BACK NOW 


7F77 


3B0A 


01460 




JR 


G.OUT 


DONE IF NOT LAST DAY 


7F79 


CD8F7F 


01470 




CALL 


TIKTOK 


ADVANCE DATE SUBROUTINE 


7F7C 


FEOD 


01480 




CP 


130 


IS IT 1 2 MONTHS? 


7F7E 


3803 


01490 




JR 


C.OUT 


: DONE IF NOT 12 MONTHS 


7FBD 


CD8F7F 


01500 




CALL 


TIKTOK 


ADVANCE DATE SUBROUTINE 


7F83 


D1 


01510 


OUT 


POP 


DE 


RESTORE DE REGISTERS 


7FB4 


E1 


01520 




POP 


HL 


RESTORE HL REGISTERS 


7FB5 


F1 


0153 




POP 


AF 


RESTORE ACCUM. & FLAGS 


7FB6 


FB 


01540 




EI 




GET CLOCK TICKING AGAIN 


7FB7 


ED4D 


01550 
015B0 




RETI 




BACK FROM THE INTERRUPT 






01570 


: Ittii 


ttttltttlttttlttlttttltt* 


tttttttttlttttttttttttttt 






015B0 


; ADVANCE TIME/DATE & RETRIEVE N 


EW VALUE SUBROUTINES 






01590 


i ittstststtstttsttte tiiitttttttt 


ntttinttttttttfittitttt 






01600 










7F8B 


AF 


01610 


TICTOC 


XOR 


A 


. CLEAR ACCUM. TO ZERO 


7F8A 


77 


01620 


FINISH 


LD 


(HL) ,A 


; HRS, MIN, OR SEC = 


7FBB 


23 


01630 




INC 


HL 


, MOVE TO NEXT POSITION 


7F8C 


34 


01640 




INC 


(HL) 


TIME = TIME + 1 (CARRY) 


7F8D 


7E 


016B0 




LD 


A, [HLJ 


; SET UP TO TEST VALUE 


7FBE 


08 


01660 




RET 




; BACK TO COMPLETE TEST 


7FBF 


3E01 


01670 


TIKTOK 


LD 


A,1 


; A = 1 FOR DAY OR MONTH 


7F91 


18F7 


01BB0 
01690 




JR 


FINISH 


; OTHER ROUTINE DOES WORK 






01700 


; ittHttitttfltttttttittttltlfl 


ttttttttttttmttiittttit 






01710 


; THIS 


IS THE 


DAYS-IN-A-MONTH LO 


OKUP TABLE - NO LEAP YEAR 






01720 


; IIHHttliltttttlttttlltHtttt 


tttttltttltltttttll until 






01730 










7F93 


00 


01740 


LOOKUP 


DEFB 


00 


i DUMMY BYTE. BUT THEN.. . 


7F94 


20 


01750 




DEFB 


32D 


; THIRTY DAYS HATH 


7F95 


10 


01760 




DEFB 


29D 


; SEPTEMBER. 


7F9B 


20 


01770 




DEFB 


32D 


; APRIL. JUNE, AND 


7F87 


1F 


01780 




DEFB 


310 


NOVEMBER: 


7F9B 


20 


01790 




DEFB 


3 2D 


i ALL THE REST HAVE 


7F99 


1F 


01800 




DEFB 


31D 


J THIRTY-ONE, 


7F9A 


20 


01810 




DEFB 


32D 


: 'CEPT FEBRUARY, AND 


7F9B 


SO 


01820 




DEFB 


3 2D 


; THERE'S BEEN ALL 


7F9C 


1F 


01830 




DEFB 


310 


; TOO MUCH TALK 


7F9D 


20 


01840 




DEFB 


320 


; ABOUT THE MYRIAD 


7F9E 


1F 


01850 




DEFB 


310 


; PRETIDIGITATIONS 


7F9F 


20 


01860 
01870 




DEFB 


320 


; USING THAT MONTH 






01 8 BO 


i Itttttttttttltlittttlttlttttil 


Httittttinitmmttttt 






01880 


■ »CMD' 


PATCH 


CHECKS PARAMETERS, 


SYNTAX, AND SETS TIME 






01800 


; ttHttttttttttttttittttHttttt 


tt DttllHlitttfttlttfttH 
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The second and third clocks for the TRS-80 
are similar in concept, but different in 
execution. That difference has only to do with 
manufacturing quality of the specifiedclock- 
calendar chip, the MSM5832 (available from 
Digi-Key Corporation and Hobbyworld 
Electronics — see Appendix). This clock- 
calendar has been designed to interface with 
microcomputers instead of the familiar red LED 
readouts. A 32.768 KHz crystal is required for 
its operation (also sold by the above suppliers). 

It provides time in hours (12 or 24), minutes 
and seconds; month, day, year (leap year as 
well) and day of the week. It has timing signal 
outputs for interrupt use, which will not be used 
in this circuit. A battery backup will keep it in 
time when the TRS-80 is turned off. Two 
complete circuits are presented in Figure 8-10 
and Figure 8-11 

Why two circuits? Because the MSM5832 is a 
relatively slow electronic circuit, and, depending 
on the quality of the production run used for the 
chip you purchase, it may or may not be fast 
enough to interface directly with your TRS-80! 

For a slower chip, you will need to use 
intermediate logic to latch onto the clock 
information in its own good time, and feed it to 
the TRS-80 as the computer's signals speed past. 
For this job, the INS8255 (as recommended by 
OKI, manufacturers of the MSM5832) is used. 
As noted above, the 8255 is a peripheral interface 
adapter, which sets up a private, latched bus 
between itself and the clock chip. Clock 
information is sent via Port A. The clock chip's 
address lines are selected through Port B, and 
other timekeeping features are selected through 
Port C. 

The 8255 will be placed in the TRS-80 
memory map at 37D0 through 37D2, below the 
cassette/ disk latches, and above the Level II 
operating system. Zl and Z2 in Figure 8-10 
decode that address group, and pins 8 and 9 of 
the 8255 (Z3) are used to select the specific 
address among those. 

The last circuit, Figure 8-11, places the 
MSM5832 directly into the TRS-80 memory 
map without use of the 8255 interface chip. 
Because the MSM5832 has four address lines, it 
is decoded differently from the 8255, but 
occupies the same general area (37D0 to 37DF) . 

Wiring all these clocks is a simple procedure 
because there are few parts. All can be soldered 
or wire wrapped, though sockets are virtually 
essential for the 8255 and MSM5832 chips. The 
latter is a static-sensitive chip, and should be 
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Figure 8-10. MSM5832 with 8255 port chip RTC. 
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1 Ic 


TYPE 


+5V 


GND 


1 Z1 


74LS30 


14 


7 


I z2 


74LS260 


14 


7 


I Z3 


74LS04 


14 


7 


I z4 


MSM5832 


1 


13 



20 pf 



Figure 8-11. MSM5832 direct to bus RTC. 
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01910 


; 








7FA0 


114340 


01920 


START2 


LD 


DE.SECOND+2 


i POINT D6 TO HOURS POS'N 


7FA3 


7E 


01930 




LD 


A,(HL) 


; CHAR AT LINE POINTER 


7FA4 


FE22 


01940 




CP 


22H 


i IS IT A QUOTE MARK? 


7FA6 


204A 


01950 




JR 


NZ, OTHERS 


i CHECK FOR CMDT OR CMDR 


7FA8 


CDDB7F 


01960 




CALL 


CONVRT 


i READ/CONV. ASCII HR, 


7FAB 


FE3A 


01970 




CP 


3AH 


: IS IT A COLON? 


7FAD 


C29719 


019B0 


SYNERR 


JP 


NZ.1997H 


: GO TO ?SN ERROR ROUTINE 


7FBD 


CDDB7F 


01990 




CALL 


CONVRT 


i READ/CONV. ASCII MIN. 


7FB3 


FE3A 


02000 




CP 


3AH 


; IS IT A COLON? 


7FB5 


20F6 


02010 




JR 


NZ, SYNERR 


! SYNTAX ERROR IF NOT : 


7FB7 


GDDB7F 


02020 




CALL 


CONVRT 


; READ/CONV. ASCII SEC. 


7FBA 


FE20 


02030 




CP 


20H 


; IS IT A SPACE? 


7FBC 


20EF 


02040 




JR 


NZ, SYNERR 


SYNTAX ERROR IF NOT 


7FBE 


114540 


02050 




LD 


DE.SECOND+4 


POINT DE TO MONTH POS'N 


7FC1 


0DDB7F 


02060 




CALL 


CONVRT 


READ/CONV. ASCII MON . 


7FC4 


FE2F 


02070 




CP 


2FH 


i IS IT A SLASH? 


7FC6 


20E5 


020BO 




JR 


NZ, SYNERR 


; SYNTAX ERROR IF NOT / 


7F08 


CDDB7F 


02090 




CALL 


CONVRT 


; READ/CONV. ASCII DAY 


7FCB 


FE2F 


02100 




CP 


2FH 


IS IT A SLASH? 


7FCD 


20DE 


02110 




JR 


NZ, SYNERR 


• SYNTAX ERROR IF NOT / 


7FCF 


114640 


02120 




LD 


DE,SEC0ND+5 


POINT DE TO YEARS POS'N 


7FD2 


CDDB7F 


02130 




CALL 


CONVRT 


READ/CONV. ASCII YEAR 


7FD5 


FE22 


02140 




CP 


22H 


IS IT A QUOTE MARK? 


7FD7 


2001 


02150 




JR 


NZ.EXIT 


DONE IF A QUOTE MARK 


7FD9 


23 


02160 




INC 


HL 


BUMP POINTER PAST QUOTE 


7FDA 


C9 


02170 
02180 


EXIT 


RET 




BACK TO BASIC 






02190 


i t**ttit*HlilfttttHttltttttttttttttttt*tltftttltttiltH 






02200 


i CONVERT ASCII 


TO HEX AND POKE INTO CLOCK TIMES LOCATION 






02210 
02220 
223 


; #*#########« 


***ntttwtttttttttttittttttitf*tttttnit 


7FDB 


23 


CONVRT 


INC 


HL 


BUMP LINE PTR. BY ONE 


7FDC 


7E 


02240 




LD 


A,(HL) 


GET CHARACTER IN LINE 


7FDD 


DB30 


02250 




SUB 


30H 


CONVERT ASCII TO HEX 


7FDF 


3C 


02260 




INC 


A 


MAKE A BE AT LEAST 1 


7FE0 


47 


2270 




LD 


B.A 


SAVE THAT VALUE IN B 


7FE1 


3EF6 


02280 




LD 


A.0F6H 


A= 100 HEX MINUS 10 DEC 


7FE3 


OBOA 


02290 


MULT 


ADD 


A.OAH 


MULTIPLY BY ADDITION 


7FE5 


10FC 


02300 




DJNZ 


MULT 


I.E., A = B TIMES 10 


7FE7 


47 


02310 




LD 


B.A 


SAVE THAT VALUE IN B 


7FEB 


23 


23 20 




INC 


HL 


BUMP LINE PTR. BY ONE 


7FE9 


7E 


02330 




LD 


A.tHL] 


GET CHARACTER IN LINE 


7FEA 


D630 


23 40 




SUB 


30H 


CONVERT ASCII TO HEX 


7FEC 


80 


02350 




ADD 


A,B 


A = (B s 10) + A 


7FED 


12 


02360 




LD 


IDE), A 


TIME IS SET, PUT IN DE 


7FEE 


1B 


02370 




DEC 


DE 


BUMP DE TO NEXT PLACE 


7FEF 


23 


23 80 




INC 


HL 


BUMP LINE PTR. BY ONE 


7FF0 


7E 


02390 




LD 


A,(HL) 


GET CHARACTER IN LINE 


7FF1 


C9 


02400 




RET 




RETURN FOR FURTHER TEST 


7FF2 


FE52 


02410 


OTHERS 


CP 


5 2H 


IS IT CMDR (CLOCK OFF)? 


7FF4 


2003 


02420 




JR 


NZ.NEXT 


NOPE, TRY FOR CMDT 


7FF6 


F3 


02430 




DI 




TURN OFF THE CLOCK 


7FF7 


23 


02440 




INC 


HL 


BUMP LINE PTR. BY ONE 


7FF8 


C9 


02450 




RET 




BACK TO BASIC PROGRAM 


7FF9 


FE54 


246 


NEXT 


CP 


54H 


IS IT CMDT [CLOCK ON)? 


7FFB 


20B0 


02470 




JR 


NZ, SYNERR 


NOPE. MUST BE ERROR 


7FFD 


FB 


02480 




EI 




TURN ON THE CLOCK 


7FFE 


23 


02490 




INC 


HL 


BUMP LINE PTR. BY ONE 


7FFF 


09 


02500 
02510 




RET 




BACK TO BASIC PROGRAM 






02520 


I ##### 


ttttttttttttltttittttttltt 


#######««############# 


7EC0 




253 




END 


ENTRY 




ODOOC 


TOTAL 


ERRORS 












handled carefully (see Chapter 4 for details). 
Use wires as short as possible in the area where 
the crystal is located, and triple-check all 
connections before applying the power. The 
MSM5832 is a delicate circuit, and at $9 a shot, 
worth the trouble to check your work. The 
circuits are connected to the computer via 
standard edge-card connectors. 



Edge Card Connectors: What's Up? 

The 40 pin bus of the TRS-80 is a 
non-standard animal to begin with, and is not 
particularly logical in its pin assignments. 
What makes things more frustrating than 
merely locating the position of the pins, is 
trying to figure out which way is up. 

The edge card of the TRS-80, when viewed 
from its edge, has pin 1 located at the top left 
a logical place. Naturally, because the CPU 
and expansion unit face each other, the entry to 
the expansion interface is the mirror image of 
this design. Yet its top left pin is also called 
'pin 1'! So pin 1 (TRS-80) leads to pin 39 
(expansion box). 

It gets stickier than this, however. When you 
are building projects, it's likely you won't be 
doing it with professionally etched edge cards, 
but rather with headers and wires and cables of 
various kinds which you assemble yourself. So 
when you get your 40 pin edge connector to 
hook onto the TRS-80, notice - 

- the numbering of the pins on the 
connector, which, if industry standards are 
used, has pin 1 marked on the opposite side, 
like the expansion box. 

- the outside wire, which may either lead to 
pin 1 or pin 2, depending on the 
manufacturer. 

- the orientation of the connecting header, 
which may reverse the process one more 

time. 

To be absolutely sure, use a meter to 
determine the path all the way from the 
computer edge card to the final connector when 
it is mounted on the project. It's best to mount 
the header or connector first, identify its pins 
with a meter, mark them and then begin work 
wire wrapping or soldering. 



MSM5832 clock board contains only 4 integrated circuits, some 
resistors, and a crystal Power supply is external, and includes 
rechargeable batteries for backup. 
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10 GLS : CLEAR 150 : REM * CRUDE BUT SERVICEABLE CLOCK PROGRAM 

20 FOR X = TO B : READ DWS(X) : NEXT : REM * ARRAY OF DAYS 

30 DATA HONDA Y,T U E S D A Y,W E N ESDAY 

40 DATA THURSDAY, FRIDAY, SATURDAY, SUNDAY 

50 PRINT "ENTER HOURS AND MINUTES, PLUS AM OR PM INDICATION." 

BO INPUT "USE FORMAT 0.3,5,8,P [= 3:58 P .M . ) " ;H0 , H1 ,M0 ,M1 , PS 

70 INPUT "12-HOUR OR 24-HOUR CLOCK* fANSWER 12 OR 24)";C$ 

80 IF P$ = "P" THEN' HO = HO + 4 : REM * BIT 3 INDICATES P.M. 

SO IF CS = "24" THEN HO = HO + 8 : REM * BIT 4 FOR 24 HOURS 

100 PRINT "DAY OF THE WEEK (ENTER 1 TO 7. MONDAY IS 1.1" 

110 INPUT DW : DW = DW - 1 : REM * CLOCK'S MONDAY IS ZERO 

120 PRINT "MONTH, DAY AND YEAR IN FORMAT 0,3,3,1,8,0 (3/31/80)" 

130 INPUT M2.M3,D0,D1 ,Y0,Y1 : REM * LEAP YEAR TEST IN NEXT LINE 

140 LY = YO + 10 * Y1 : IF LY./4 = FIX (LY/4) THEN DO = DO + 4 

150 POKE 14281,128 : REM * SET UP B255 CHIP PORTS 

160 POKE 14290,80 : REM * SET UP CLOCK TO READ TIME AND DATE 



170 = 14289 

1B0 POKE a, 2 

190 POKE Q,4 

200 POKE Q.,6 

210 POKE Q,8 

220 POKE Q,10 

230 POKE 0,12 

240 POKE 14291 ,144 : CLS 

250 PRINT § 

260 POKE 14290,32 



REM * THIS IS CLOCK ADDRESS REBISTER 



POKE Q.3 : POKE 0-1 ,M0 
POKE Q,5 : POKE Q-1 ,H0 
POKE Q,7 : POKE Q-1 , D1 
POKE Q,9 : POKE 0-1 ,M3 
POKE Q, 11 : POKE 0-1 ,Y1 
REM * TIME AND DATE INFO SET 
REM » DISPLAY SUBROUTINE FOLLOWS 
REM * DISPLAY IS ON TOP LINE OF SCREEN 
REM * SET UP CLOCK TO WRITE TIME AND DATE 



POKE Q-1 ,M1 
POKE Q-1 ,H1 
POKE Q-1 ,DW 
POKE Q-1 ,D0 
POKE Q-1 ,M2 
POKE Q-1 ,Y0 



270 POKE Q, 6 

280 POKE Q,10 

290 POKE Q, 9 

300 POKE Q,8 

310 POKE Q,7 

320 POKE Q.12 

330 POKE Q,11 

340 POKE Q, 5 

350 POKE Q,4 

360 POKE Q,3 

370 POKE Q,2 

380 POKE Q,1 

390 POKE Q,0 

400 POKE Q,5 
410 



PRINT DWS (PEEK (Q-1) AND 151", 

PRINT PEEK (Q-1) AND 15; CHRS(8) 

PRINT PEEK (Q-1) AND 15; 

PRINT PEEK (Q-1 ) AND 3; 

PRINT PEEK (Q-1) AND 15; 

PRINT PEEK (Q-1 ! AND 15; 

PRINT PEEK (Q-1) AND 15; 

PRINT PEEK (Q-1) AND 3; 

PRINT PEEK (Q-1) AND 15: 

PRINT PEEK (Q-1) AND 15: CHRS(B) 

PRINT PEEK (Q-1) AND 15; 

PRINT PEEK (Q-1) AND 15; 

PRINT PEEK (Q-1) AND 15; 

IF (PEEK (Q-1) AND 4) = THEN PRINT 

IF (PEEK (Q-1) AND 4) = 4 THEN PRINT 



CHRStB 

CHRS18 
tr ii 

CHRS18 
ii . ti . 



CHRSIB 



M. 



420 IF (PEEK(14312) AND 1 2B ) = THEN 500 ELSE 250 

430 REM : THIS ROUTINE IS MUCH LONGER THAN IT NEED BE, 

440 REM : BUT IS SET UP FOR CLARITY, NOT EFFICIENT USE 

450 REM : OF MEMORY. IT IS EASIER TO USE THE MACHINE 

460 REM : LANGUAGE SUBROUTINE FOR THIS CLOCK CIRCUIT. 

500 AS = "" : FOR X = 1536D TO 15424 : AS = AS + CHRSIPEEK(X) 

510 NEXT : LPRINT AS : GOTO 250 

Listing 8-3. BASIC program for MSM5832/8255. 



7E00 
7E03 
7E06 
7E09 
7E0C 



7E0F 
7E10 
7E11 
7E13 



7E16 
7E1S 
7E1D 
7E21 
7E24 
7E28 



210F7E 
227741 
21BF7E 
227441 
C3CC06 



D7 
65 

3E18 
CD5728 



2AD440 

FD21D037 

FD360390 

CD6A7F 

FD360220 

CD6A7F 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
240 
00250 
00260 
00270 
00280 
002B0 
00300 
00310 
00320 
00330 
00340 
00350 
00360 
00370 
00380 
00390 
00400 
00410 
00420 
00430 
00440 
00450 
00460 
047 
04 BO 
00490 
00500 
00 510 
00520 
00530 
00540 
00550 



, inLitBtittHttttttittitttitttttttltttltttttttttlltttttt 
I MACHINE LANGUAGE CLOCK PROGRAM FOR MSM5B32 CLOCK BOARD 
; ATTACHED TO THE TRS-80 AT ADDRESS 1428B TO 14300, USING 
; THE "TIMES" FUNCTION. THIS ROUTINE IS TRANSPARENT TO 
; BUT IS NOT CALLED BY THE CUSTOM INTERPRETER. HENCE, 
: IT OPERATES INDEPENDENTLY FROM THE INTERPRETER PATCH. 
; ttt*ttttHlftttUt*tttttltttt**tti*ttftHtt*ltittt*H*l 



ORG 



7E00H 



: CHANGE TO RELOCATE 



LD 


HL.START1 


LD 


(4177H) ,HL 


LD 


HL.START2 


LD 


(4174H) ,HL 


JP 


06CCH 



ttttt**ttHttttttttlHtittttfft*tttt***ttt*l**t*l****t* 
PATCH INTO DOS TIMES ERROR LOCATION AND CHANGE IT 

ttt*tttmt**tut*t*ttniiiniittt*tMftttntm*ttin 

START OF TIMES PROGRAM 
PATCH TIMES ?L3 ERROR 
START OF "CMD" PROGRAM 
PATCH CMD ?L3 ERROR 
BACK TO A BASIC "READY" 

t*ttttttttttU*tttttttt*t*tt*tti*ttttt*tt ttttitlttttt** 
THIS IS THE BEGINNING OF TH "TIMES" PATCH TO READ TIME. 
ROUTINE INTERCEPTS 7L3 ERROR AND CHECKS LINE'S SYNTAX. 

tttttttttttt*t*ttttitt**t*t**tt*t****tt*t**t*ttt*tt*ttt 

BASIC HOUSEKEEPING 
SAVE BASIC LINE POINTER 
LENGTH OF TIMES 
ROM STRING SPACE SETUP 

tttttttt»ttttttttttt*littttttttt*ttt*ttt**iittttttttttt 
SET UP RAM SPACE AND GET CLOCK CHIP READY TO READ TIME 

nnntttttttt»tttttttt*t**i*#ititntiinii>*nntttniii 

LOCATION TO STORE TIMES 
CLOCK MEMORY ADDRESS 
SET UP B255 CHIP PORTS 
WAIT FOR SLOW MSM5832 
SET UP CLOCK TO READ 
WAIT FOR SLOW MSM5B32 

nti>niiiinntntttttt«§ittiiti*ttt**ttitinini*tt»ttt 

CLOCK IS READY TO READ ... NOW READ AND CREATE STRING. 
DAY OF THE WEEK IS ALPHABETIC AND WILL BE DONE FIRST. 

tttttttitnttttttnittttnti»tttt**ttn*ttitttitt»n*t* 



RST 


10H 


PUSH 


HL 


LD 


A.18H 


CALL 


2857H 



LD 


HL,(40D4Hl 


LD 


IY.37D0H 


LD 


(IY+3) ,90H 


CALL 


DELAY 


LD 


(IY+2) ,20H 


CALL 


DELAY 



To use the MSM5832 clock with the 8255 
interface adaptor, you will need to refer to both 
chips* programming information. Figure 8-(?), 
earlier in this chapter, contains the 8255 
programming parameters. Figure 8-(?) shows 
how the clock's registers are set up. 

At first, this process may appear confusing. 
What is being done? Three semi-intelligent 
electronic devices are being taught to talk to one 
another. The TRS-80 knows it wants to read and 
write to memory. The 8255 is that memory. But 
the 8255 has a mind of its own, and that mind can 
only be controlled by selecting its control 
register, telling it what purpose each of its three 
ports is to serve, and then reading and writing 
those ports. Finally, the MSM5832 also has a 
mind of its own. It will neither report nor accept 
the time until it is told what aspect of the time is 
needed, and that too is done via a control register. 

Figure 8-(?) is a flow chart which describes the 
process, and Listing 8-(?) is a BASIC program 
which fairly well describes the steps needed to 
access the MSM5832 chip, 'way down the chain. 



Eliminating the 8255 by using the second 
circuit means only one set of electronic parts 
must be taught to speak to each other. The 
TRS-80 can probe right into the MSM5832 
control register to select which aspect of the time 
and date it wishes. 

Each of the machine language programs 
presented in Listings 8-(?) and 8-(?) use the 
TIME$ and CMD commands to set and recall the 
time. To set the time and date, enter : 

CMD"M0N 03/14/49 02:28 PM" 



Notice that this differs from the interrupt 
driven clock (Listing 8-(?)) in that the day of the 
week and morning - afternoon indicators must 
be given. Remember to use the punctuation and 
spacing exactly as printed here. As with the 
interrupt clock, PRINT TIME$ returns the time 
and date, and this TIME$ can be used and 
manipulated just as any other string. 



A complete description of these programs is 
given in the Supplement to this Chapter. 



Listing 8-4. Assembly program for MSM5832/8255. 
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7E2B FD360106 00560 




LD 


(IY+1) ,6 




; POINT TO DAY OF WEEK 


7E2F CDBA7F 


00570 




CALL 


DELAY 




i WAIT FOR SLOW MSM5832 


7E32 FD7E00 


005B0 




LD 


A,[IY+0) 




: GET DUMMY VALUE INTO A 


7E35 CD6A7F 


00590 




CALL 


DELAY 




i WAIT FOR SLOW CHIP t ! ) 


7E38 FD7E00 


00600 




LD 


A,(IY+0) 




; GET DAY OF WEEK VALUE 


7E3B E6 07 


00610 




, AND 


07 H 




: MASK OFF UNUSED BITS 


7E3D 11757F 


00620 




LD 


DE, TABLE 




: POINT DE TO DAY TABLE 


7E40 3G 


00630 




INC 


A 




; IT MUST BE AT LEAST 1 


7E41 3D 


00640 


LO0P1 


DEC 


A 




: IS ACCUMULATOR ZERO? 


7E42 2807 


00650 




JR 


Z, XLOOP 




; GO OUT OF TABLE LOOP 


7E44 0603 


00660 




LD 


B,3 




; NUMBER OF CHARS PER DAY 


7E46 13 


00670 


LOOP 2 


INC 


DE 




i MOVE PAST EACH CHAR 


7E47 10FD 


006 BO 




DJNZ 


LOOP 2 




; DO IT TILL AT NEXT DAY 


7E49 1BF6 


00690 
00700 




JR 


L0OP1 




: CHECK FOR NEXT DAY 




00710 


; *#J# 


»t*titnt*t»ttttt**tnttittttttttttttnttttt§tttt*t. 




00720 


; VALUE FOR DAY IS FOUND 




NOW TURN IT INTO LETTERS 




00730 
00740 


; #### 


nettti 


################ 


ItttttttttllHtltttttHltttt 


7E4B 0603 


00750 


XLOOP 


LD 


B,3 




i NUMBER OF CHARS TO GET 


7E4D 1A 
7E4E 77 


00760 
00770 


YLOOP 


LD 
LD 


A, IDE! 
(HL) ,A 




; CHARACTER TO TRANSFER 
; XFER DAY NAME TO TIMES 


7E4F 23 


07 80 




INC 


HL 




i NEXT LOCATION IN TIMES 


7E50 13 


007 90 




INC 


DE 




; NEXT LOCATION IN TABLE 


7E51 1 QFA 


00800 




DJNZ 


YLOOP 




; LOOP BACK FOR NEXT CHAR 


7E53 3620 


00810 




LD 


(HL] ,20H 




; PUT SPACE AFTER DAY 


7E55 23 


00820 
00830 




INC 


HL 




; BUMP TIME BUFFER AGAIN 




00B40 


: «## 


stums 


tttWSSittgSS 


#### 


ttttttlHttlttttttittHHItt 




00B50 


; DAY 


3F WEEK 


IS DONE ... 


NOW 


GET MONTH. DAY. AND YEAR 




00860 


i #### 


?###### 


####«#«### 


#«##########S*#######S#f#f ###### 




00B70 












7E86 1E30 


008 80 




LD 


E.30H 




; HEX TO ASCII DIFFERENCE 


7E5S 160B 


008 90 




LD 


0,11 




; MONTH HI PORT + 1 


7E5A 062F 


00900 




LD 


B.2FH 




; SLASH ("/"] CHARACTER 


7ESC OEOF 


00^10 




LD 


C.OFH 




; MASK UNUSED PORT BITS 


7E5E CD557F 


00920 




CALL 


FILLER 




: GET MONTH HIGH VALUE 


7E61 CD5S7F 


00930 




CALL 


FILLER 




; GET MONTH LOW VALUE 


7E64 70 


00840 




LD 


(HL) ,B 




; LOAD SLASH INTO TIMES 


7E6S 23 


00950 




INC 


HL 




; BUMP TIME BUFFER BY ONE 


7E66 0E03 


00960 




LD 


C,3 




i MASK UNUSED CLOCK BITS 


7E68 CD557F 


00970 




CALL 


FILLER 




; GET DAY HIGH VALUE 


7E6B OEOF 


00980 




LD 


COFH 




: MASK UNUSED CLOCK BITS 


7E6D CD557F 


009 90 




CALL 


FILLER 




i GET DAY LOW VALUE 


7E70 70 


01000 




LD 


(HL) ,B 




i PUT SLASH INTO TIMES 


7E71 23 


01010 




INC 


HL 




; BUMP TIME BUFFER BY ONE 


7E7E 160D 


01020 




LD 


D,13 




i YEAR HIGH VALUE + 1 


7E74 0D557F 


01030 




CALL 


FILLER 




: GET YEAR HIGH VALUE 


7E77 CD557F 


01040 




CALL 


FILLER 




; GET YEAR LOW VALUE 


7E7A 3620 


01050 




LD 


(HL] ,20H 




; VALUE FOR A SPACE 


7E7C 23 


01060 
01070 




INC 


HL 




; BUMP TIME BUFFER BY ONE 




01080 


; ##«##««# 


t*HilttttttttHtti*ttttftttltttttitHtltttt 




01090 


; MONTH 


, DAY, 


YEAR DONE - 


NOW 


GET HOURS, MINUTES. SECONDS 




01100 


; ttittttltlt 


titnfitttit*ttititttittntt§ttttttittntnt 




01110 












7E7D 1605 


01120 




LD 


D,5 




: HOURS HIGH VALUE 


7E7F FD7201 


01130 




LD 


(IY+1) ,D 




; SET UP CLOCK CHIP PORT 


7E82 CD6A7F 


01140 




CALL 


DELAY 




i DELAY FOR B255 CHIP 


7EB5 FD7E00 


01150 




LD 


A,(IY+0) 




i DUMMY VALUE INTO ACC. 


7EB8 CD6A7F 


01160 




CALL 


DELAY 




; DELAY AGAIN FOR CHIP I 


7EBB FD7E00 


01170 




LD 


A,(IY+0) 




; GET HOURS HIGH VALUE 


7E8E F5 


01180 




PUSH 


AF 




; SAVE THIS FOR AM/PM 


7E8F 14 


01190 




INC 


D 




i ACCOMMODATE SUBROUTINE 


7E90 0E03 


01200 




LD 


C,3 




f MASK UNUSED CLOCK BITS 


7E92 CD557F 


01210 




CALL 


FILLER 




; GET HOURS HIGH VALUE 


7E95 OEOF 


01220 




LD 


C.OFH 




: MASK UNUSED CLOCK BITS 


7E97 C0557F 


0123 




CALL 


FILLER 




; GET HOURS LOW VALUE 


7ESA 363A 


01240 




LD 


(HL) ,3AH 




; PUT A COLON IN TIMES 


7E9C 23 


01250 




INC 


HL 




; BUMP THE STRING ALONG 


7E9D 0602 


01260 




LD 


B,2 




; NUMBER MINUTE/SEC LOOPS 


7E9F 0D557F 


01270 MINSEC 


CALL 


FILLER 




; GET, CONVERT, SAVE VALUE 


7EA2 CD557F 


01280 




CALL 


FILLER 




; GET, CONVERT, SAVE VALUE 


7EA5 363A 


01290 




LD 


(HL) ,3AH 




; VALUE FOR A COLON 


7EA7 23 


01300 




INC 


HL 




; BUMP TIME BUFFER BY ONE 


7EA8 10F5 


01310 




DJNZ 


MINSEO 




; GO BACK FOR .MIN/SEC 


7EAA 2B 


01320 




DEC 


HL 




; BACK UP TO LAST COLON 


7EAB 3620 


01330 
01340 




LD 


(HL) ,20H 




; CHANGE TO STRING END 




01350 


ttiitltttttttttltttttttf 


f»SS 


«##########«########»### 




01360 


HOURS 


, MINUTES, SECONDS 


ARE 


DONE ... NOW FIGURE AM/PM 




01370 


##### 


«««########«##*#####«#############«######### 




01380 












7EAD 23 


01390 




ING 


HL 




i BUMP TIME BUFFER BY ONE 


7EAE F1 


01400 




POP 


AF 




1 GET BACK HOUR HI VALUE 


7EAF CB57 


0141 




BIT 


2, A 




; CHECK AM/PM INDICATOR 


7EB1 2804 


01420 




JR 


Z.MORNNB 




; MORNING IF BIT 2=0 


7EB3 3650 


0143 




LD 


(HLJ ,50H 




: PUT LETTER "P" IN PLACE 


7EB5 1802 


01440 




JR 


NEXT 




; JUMP PAST LETTER A 


7EB7 3641 


01450 HORNNG 


LD 


(HL) ,41H 




; PUT LETTER "A" IN PLACE 


7EB9 23 


01460 NEXT 


INC 


HL 




! BUMP TIME BUFFER BY ONE 


7EBA 364D 


01470 




LD 


(HL) ,4DH 




; PUT LETTER "M" IN PLACE 


7EBC C3B42B 


014B0 
01490 




JP 


2BB4H 




: BACK TO BASIC ACTIVITY 




01500 


## vv$8vvv§vi 


sistssssmisftstt 


##«#««««######«««## 




01510 


THIS 


IS THE 


BEGINNING OF 


THE 


"CMD" PATCH TO SET TIME 




01520 , 


CHECK 


FOR TIME SETTING PARAMETERS AND SYNTAX 




01530 : 


####«####« 


tUttttttttttttttttttttttttttttHttltttittt 




01540 ; 












7EBF 7E 


01550 START2 


LD 


A,(HL) 




i CHAR AT LINE POINTER 


7EC0 FE22 


01560 




CP 


22H 




.: IS IT A QUOTE MARK? 


7EC2 C29719 


01570 




JP 


NZ.1997H 




: ?SN ERROR IF NO QUOTE 



Bank Selecting Machine Language in 
ROM 

Warning: Before you begin construction of 
anything in this section, read the rest of the 
chapter! You might want to construct the 
complete ROM/RAM bank select system. 

Seriously, one of the most exciting aspects of 
the TRS-80 is its blank area in the memory map. 
This has been partially used in this chapter to 
install a real time clock. It can also be used to 
select machine language programs or data 
burned into ROMs. At the time of this book's 
publication, the cost of a 2K erasable, 
programmable, read only memory (EPROM) is 
less than $8. A year earlier, when these memories 
were $27 or more, this project would not have 
been practical. Now it is. 

In quantities of 100, these EPROMs are less 
than $5, which means, by using this project, 
direct access to over 200K of memory is possible 
for less than $500. But one or two of such 
memories are just as valuable. 

But first, what is an EPROM? How is it used? 
An EPROM, as its name suggests, is a memory 
which the user can program and reprogram as 
necessary. It is programmed with an EPROM 
programmer, and erased with ultraviolet light. It 
maintains its contents with the power off, just 
like the Level II ROMs themselves. It is used in 
a way even simpler than the way the TRS-80's 
RAM memory is used, and in this is found its 
great advantage: it needs but power, address and 
data lines to make its data available to the CPU. 

By using a decoded output port, one of a bank 
of these memories may be selected for use. Here 
is an example; I might want to load a special 
machine language monitor program. I know that 
program is located in ROM #26 in my ROM 
bank. I can command something like - 



OUT 31 ,26 <ENTER> 

SYSTEM <ENTER> 

/12288 <ENTER> 



- and my program will be loaded and active. 
Only the time for three entries has been spent; 
not even the time of the disk access. And, beyond 
that, no RAM memory need be used! 

A complete circuit for a ROM select bank is 
presented in Figure 8-14. Each of the lines 
marked 'to ROM' will select one of 256 possible 
ROMs! 
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Figure 8-14. Bank-selected ROMs. 
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Figure 8-15. Bank- selected ROM/RAM. 
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7E05 
7EC6 
7EC7 
7 EGA 
7EGC 
7ECE 
7ECF 
7ED0 
7ED1 
7ED2 
7ED4 
7ED5 
7ED7 
7ED8 
7EDA 
7EDB 
7EDD 
7EDE 
7EE1 
7EE2 
7EE3 



23 

E5 

11757F 

0E00 

0803 

E1 

E5 

1A 

A7 

2609 

BE 

280A 

13 

10FD 

OC 

18EF 

E1 

C39719 

23 

13 

10EB 



7EES F1 
7EEB FD3603BD 
7EEA CD6A7F 
7EE0 FD360250 
7EF1 CDBA7F 
7EF4 79 
7EFS FD360106 
7EF9 CDSA7F 
7EFC FD7700 



7EFF 
7F01 
7F04 
7F07 
7F09 
7F0C 
7F0E 
7F11 
7F14 
7F16 
7F17 
7F19 



7F1A 
7F1B 
7F1C 
7F1D 
7F20 
7F21 
7F22 
7F24 
7F2B 
7F28 
7F29 
7F2A 
7F2B 
7F2D 
7F2E 
7F2F 
7F31 
7F33 
7F34 



7F37 
7F39 
7F3B 
7F3C 
7F3D 
7F3E 
7F3F 
7F41 
7F43 
7F45 
7F4B 
7F4B 
7F4E 
7F51 
7F53 
7F54 



160B 

0D377F 

CD377F 

160D 

CD377F 

1605 

0D1A7F 

0D377F 

0604 

23 

10FD 

CB 



23 

E5 

D5 

110600 

19 

7E 

FE41 

3E04 

2001 

AF 

01 

E1 

0602 

4F 

7E 

D630 

38AA 

81 

C3417F 



1E3 

0602 

15 

23 

7c 

93 

3S9C 

FEOA 

3088 

FD7201 

CD6A7F 

FD7700 

GD6A7F 

10E8 

23 

C9 



01580 

01590 

01600 

01610 

01620 

01630 

01640 

01650 

01660 

01670 

01680 

01890 

01700 

01710 

01720 

01730 

01740 

01750 

017B0 

01770 

017B0 

01790 

01800 

01810 

01B20 

01830 

01840 

01850 

01860 

01870 

01B80 

01B90 

01900 

01910 

01920 

01930 

019 40 

01950 

01960 

01970 

01980 

01990 

02000 

02010 

02020 

02030 

02040 

02050 

02060 

207 

02080 

02080 

02100 

02110 

02120 

02130 

2140 

02150 

02160 

02170 

021B0 

02190 

02200 

02210 

02220 

223 

02240 

02250 

02260 

02270 

02280 

02290 

02300 

02310 

023 20 

02330 

02340 

02350 

02360 

02370 

02380 

02390 

240 

02410 

02420 

02430 

02440 

02450 

0246 

02470 

24B0 

2490 

02500 

02510 

02520 

0253 

02540 

02550 

02560 

02570 

025B0 

02590 



ERR0R1 
ERR0R2 
GOTONE 



INC 

PUSH 

LD 

LD 

LD 

POP 

PUSH 

LD 

AND 

JR 

CP 

JR 

INC 

DJNZ 

INC 

JR 

POP 

JP 

INC 

INC 

DJNZ 



HL 

HL 

DE, TABLE 

CO 

B,3 

HL 

HL 

A,(DE) 

A 

Z.ERR0R1 

(HL) 

Z, GOTONE 

DE 

L0.0P4 

C 

DYLOOP 

HL 

1897H 

HL 

DE 

FINDIT 



BUMP LINE PTR. BY ONE 
SAVE THE LINE POINTER 
GET TABLE OF DAY NAMES 
THIS WILL BE COUNTER 
NUMBER OF CHARS IN DAY 
GET LINE POINTER BACK 
SAVE AGAIN FOR LOOP USE 
GET 1ST CHAR OF STRING 
EASY WAY TO SET A FLAG 
VALUE = . . . ?SN ERROR 
CHECK IT AGAINST TABLE 
GET READY FOR NEXT CHAR 
RUN PAST VALUES FOR DAY 
BY RUNNING B TO ZERO 
NEXT DAY - BUMP COUNTER 
BACK TO NEXT DAY LOOP 
CLEAR STACK OF HL REG. 
GO TO ?SN ERROR MESSAGE 
GET NEXT CHAR FROM LINE 
BUMP TABLE VALUE ALONG 
KEEP GOING TILL DONE 



POP 


AF 




LD 


(IY+3) 


■ BOH 


CALL 


DELAY 




LD 


(IY+2) 


.50H 


CALL 


DELAY 




LD 


A,C 




LD 


(IY+1) 


,6 


GALL 


DELAY 




LD 


(IY+Ol 


,A 



ttlt**t**n*tttttttn***ttt*ttntttuttt*t»nt*tltt*tt* 

NUMERICAL VALUE FOR DAY IS IN C - PUT IT IN MSM5832 
tUittt**t*ttt***t**t*»**t*tt*********H****l********** 

CLEAR STACK OF HL VALUE 
SET UP 8255 TO WRITE 

THAT #E,I*X SLOW MSM5B3S 
CLOCK CHIP WRITE VALUE 
HOW SLOW IS IT?I? 
GET DAY OF WEEK VALUE 
READY TO WRITE DAY 
WAIT (YAWN) TO WRITE 
WRITE DAY TO CLOCK 

tt*ttttttttt*HHt*tt**tltttt»t*t**tf*t*tttt*t*itl**tt* 

DAY IS WRITTEN - FIND MONTH, DAY. YEAR AND WRITE THEM 
ttlttttttttHtttt*H»**i*t*i***titttf*tttt*tt**H*ltilt 

VALUE FOR MONTH + 1 
WRITE MONTH TO CLOCK 
WRITE DAY TO CLOCK 
VALUE FOR YEAR +1 
WRITE YEAR TO CLOCK 
SET TO HOURS HIGH VALUE 
WRITE HOURS TO CLOCK 
WRITE MINUTES TO CLOCK 
NUMBER OF CHARS LEFT 
BUMP LINE POINTER 
LOOP PAST "PM" & QUOTES 
BACK TO BASIC PROGRAM 

tttttttHttltlttlttH**ttHttttt*tt**t*t*****t**ttHH* 

CHECK FOR AM OR PM INDICATION AND WRITE THAT VALUE 
itttt*tiitHttttHtttttHttttHttttttttttttttit l H**it*t 



LD 


D,11 


CALL 


TIMSET 


CALL 


TIMSET 


LD 


0,13 


CALL 


TIMSET 


LD 


D,5 


CALL 


AMORPM 


CALL 


TIMSET 


LD 


8,4 


INC 


HL 


DJNZ 


SNEAK 


RET 





INC 

PUSH 

PUSH 

LD 

ADD 

LD 

CP 

LD 

JR 

XOR 

POP 

POP 

LD 

LD 

LD 

SUB 

JR 

ADD 

JP 



HL 

HL 

DE 

DE.6 

HL.DE 

A,(HL) 

41 H 

A, 4 

NZ.EVENNG 

A 

DE 

HL 

B,2 

C,A 

A,!HL) 

3 OH 

CERR0R1 

A,C 

MIDDLE 



BUMP LINE TO NEXT CHAR. 
SAVE CURRENT LINE PTR. 
SAVE OTHER VALUES IN DE 
HOW MANY SPACES TO MOVE 
FIND AM OR PM IN LINE 
GET CHARACTER FROM LINE 
SET FLAG IF CHAR. = "A" 
GET PM INDICATOR READY 
ZERO FLAG NOT SET IF PM 
CLEAR PM INDICATOR 
RESTORE VALUES TO DE 
GET ORIGINAL LINE PTR. 
SET UP B AS TIMSET LOOP 
SAVE AM/PM INDICATOR 
GET VALUE FROM LINE 
STRIP ASCII MASK 
ERROR IF LESS THAN 
ADD AM/PM BIT TO VALUE 
SUBROUTINE FINISHES JOB 



ttttttt***t*tt*ttt*tlitttttttt*ttttttttttttttttit»ttit* 

TIME SETTING SUBROUTINE CHECKS LINE FOR SYNTAX 



MIDDLE 



LD 

LD 

DEC 

INC 

LD 

SUB 

JR 

CP 

JR 

LD 

CALL 

LD 

CALL 

DJNZ 

INC 

RET 



E.30H 

8,2 

D 

HL 

A,(HL1 

E 

C.ERR0R1 

OAH 

NC.ERR0R1 

C IY+1 ) ,D 

DELAY 

tIY+0) ,A 

DELAY 

ZLOOP 

HL 



CONVERTS ASCII TO HEX 
LOOP TWICE FOR 2 DIGITS 
BUMP CLOCK ADDRESS PORT 
GET NEXT CHAR FROM LINE 
MOVE IT TO ACC. TO TEST 
STRIP OFF ASCII VALUE 
ERROR IF LESS THAN 
CHECK IF GREATER THAN 9 
ERROR IF GREATER THAN 9 
OPEN PORT TO CLOCK 
THE USUAL CMOS WAIT 
WRITE VALUE TO CLOCK 
WAIT I WAIT I WAIT I I I ! I 
DO IT FOR 2 DIGITS 
BUMP PAST / : OR SPACE 
BACK TO MAIN PROGRAM 



GET VALUE, CONVERT TO ASCII, AND SAVE IN TIMES BUFFER 
ttHtttttiHt*tttttttttttttttttttH*Httt**t*t*ttt*»ttt 



Actually, the bank-select ROM idea is only 
one part of a larger possibility — blocks of ROM 
and/or RAM placed interchangeably. Ideally 
the additional RAM would be available in 
higher memory, but the TRS configuration is so 
locked into its memory map that expansion in 
high memory would require major reconfiguring 
of the memory and refresh circuits. With that in 
mind, then, all this expansion will be dedicated 
to the free area located at 3000 to 37E0. 

This memory addition is an application of a 
'Read-Only-RAM' concept. Simply stated, the 
memory write (WR) line to read/write memory is 
disabled by the user in order to outline an area of 
protected, but not permanently programmed, 
memory. Machine language programs under 
development can be emulated with this system. 
Crucial software can be embedded in crash- 
proof RAM, and the occasional nuisance of a 
program gone wild will not affect data in this 
area. 

The inclusion of bank selection in this area 
permits the use of interchangeable, and 
constantly on-line, blocks of ROM, RAM, and 
protected RAM. In Figures 8-16 and 8-17 , the 
ROMs used, as before, are 2716 EPROMs, and 
the RAMs are of the static variety. Two designs 
of the circuit are shown: one uses 2114 static 
RAMs, which are IK by 4 bits wide; the other 
uses 4118 static RAMs, each a full IK by 8 bits 
wide. The former memories are considerably 
less expensive, but the latter are easier to wire in 
a wire-crazy bank select scheme like this one. 

As before, output port 31 has been chosen for 
the memory, and each 2K block is selected by the 
value output through port 31. Furthermore, 
RAM data in the unselected blocks remains 
intact, ready to use whenever a different value is 
output through port 31. 

The bank-selected ROM may be used for the 
most part as any other memory, with one very 
interesting exception: routines in different 
ROMs may not call or jump to each others' 
routines in the normal way. Instead, two special 
routines must be used. 

The jump routine is the simplest: the ROM's 
position in the bank must be identified, the jump 
prepared and the OUT statement commanded. 
The easiest way to do this is shown in Listing 
8-7); the AF and HL registers are saved on the 
stack, then AF is loaded with the location of the 
routine (which it must obtain from a table of 
some sort identical in each ROM). Following 
that, the HL register pair is loaded with the jump 
address, and the OUT (IF), A command is then 
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7F55 
7F56 
7F59 
7F5C 
7F5F 
7FB2 
7F65 
7F66 
7FB7 
7F68 
7FB8 



15 

FD7201 

CD6A7F 

FD7E00 

0D6A7F 

FD7E00 

A1 

83 

77 

23 

C9 



7F6A C5 
7F6B FS 
7FBC 010100 
7F6F CD6D00 
7F72 F1 
7F73 C1 
7F7.4 CS 



7F75 4D 
7F78 54 
7F7B 57 
7F7E 54 
7FB1 4B 
7FB4 53 
7FB7 53 
7FBA 00 



7E0Q 

00000 TOTAL 



02600 FILLER 

02610 

02620 

2630 

026 40 

02650 

02660 

02670 

2BB0 

02690 

02700 

02710 ; 

02720 

02730 

27 40 

02750 ; 

02760 DELAY 

27 70 

27 BO 

27 90 

02800 

02B10 

02B20 

02S30 

02840 

02850 

02860 

02870 : 

02B80 TABLE 



DEC 

LD 

CALL 

LD 

CALL 

LD 

AND 

ADD 

LD 

INC 

RET 



[IY+1 J .D 

DELAY 

A.UY+OJ 

DELAY 

A, UY+O) 

C 

A,E 

[HL! ,A 

HL 



BUMP CLOCK PORT ADDRESS 
POINT TO VALUE WANTED 
THAT OL 1 SLOW MSM5B32 
GET DUMMY VALUE INTO A 
WAIT AGAIN I SLOW CHIP 
NOW GET VALID VALUE 
MASK UNUSED BITS 
MAKE IT AN ASCII VALUE 
PUT VALUE INTO BUFFER 
NEXT BUFFER POSITION 
BACK TO MAIN PROGRAM 



ItHi 

THIS 

tSitil 



IS A SETUP WHICH CALLS A DELAY SUBROUTINE IN ROM 



PUSH 

PUSH 

LD 

CALL 

POP 

POP 

RET 



BC 

AF 

BC,1 

0060H 

AF 

BC 



SAVE BC REGISTER PAIR 
SAVE AF REGISTER PAIR 
DELAY FOR MSM5B32 CHIP 
HERE IS ROUTINE IN ROM 
GET AF REGISTERS BACK 
GET BC REGISTERS BACK 
BACK TO MAIN PROGRAM 



tttti 
THIS 



02B9D 
2S0 
02910 
02920 
02930 
02940 
02950 
02960 
02970 
02980 
02990 
03DOO 
03010 
03020 
03030 
03 040 
03050 
ERRORS 



ttttlttttttttttiltittttttttlHttlilHttttHttHli 
IS THE LOOKUP TABLE OF DAYS OF THE WEEK 

DEFM 'HON' 
DEFM 'TUE' 



DEFM 
DEFM 
DEFM 
DEFM 
DEFM 
OEFB 



'WED 1 
'THU' 
'FRI ' 
'SAT' 
'SUN' 



ttlHtHttttttttfStt§lttttHtltlttittlHmiittlHt 
END ENTRY 



executed, which switches ROMs. The proper 
jump address is still in HL, so a simple JP (HL) 
effects the jump. 



ROUTINE BEING LEFT MUST PROVIDE THIS 
INFORMATION TO AF AND HL REGISTERS 



..ZZZZ 

..YYYY 

3ENN 

21NNNN 

C3WWWW 



D31F 

E9 

. .ZZZZ 

..xxxx 

D31F 
C9 



.ZZZZ 
.YYYY 



LD 
LD 
LD 
LD 
JP 



(ZZZZ) ,A 
[YYYY) ,HL 
A,NN 
HL.NNNN 
XFER1 



SAVE AF VALUES 
SAVE HL VALUES 
NEW ROM BANK NUMBER 
JUMP ADDRESS 
MAKE ROM TRANSFER 



ALL ROMS CONTAIN THE FOLLOWING IDENTICAL 
; BYTES AT THE SAME ADDRESSES IN ROM 
OUT (1FJ.A ; SWITCHES ROMS 

JP [HLJ ; JUMPS TO ROUTINE 

LD (ZZZZ) ,A ; NOT USED IN JUMP 
LD A, (XXXX) ; NOT USED IN JUMP 
OUT t1F),A ; NOT USED IN JUMP 

RET i NOT USED IN JUMP 

; ALL ROUTINES BEING ENTERED MUST PROVIDE 
i THE FOLLOWING RESTORATION CODING 
LD HL.(ZZZZ) ; RESTORE HL VALUES 
LD A, [YYYY) ; RESTORE AF VALUES 



Listing 8-6. Accessing multiple ROMs (jumps). 



Calling a subroutine in another ROM is more 
complicated, but still can be done. Listing 8-(?) 
shows how it might be achieved. 



; ROUTINE BEING LEFT MUST PROVIDE THIS 
i INFORMATION IN AF AND HL REGISTERS 



. .ZZZZ 




LD [ZZZZ) ,A 




SAVE AF DATA 


..YYYY 




LD (YYYY) ,HL 




SAVE HL DATA 


DB1F 




IN A.(1F) 




GET ROM BANK NUMBER 


..XXXX 




LD [XXXX) ,A 




SAVE ROM BANK NO. 


21NNNN 




LD HL.NNNN 




GET CALL ADDRESS 


CDWWWW 




CALL XFER2 




MAKE ROM TRANSFER 






; THE FOLLOWING CALLING ROUTINE MUST BE 






i PLACED IN ALL ROMS 


AT 


IDENTICAL LOCATION 


031 F 


XFER2 


OUT [1F),A 




SWITCH ROMS 


E9 




JP (HL) 




ENTER ROUTINE 


..ZZZZ 


BACK 


LD [ZZZZ] .A 




SAVE AF DATA 


..XXXX 




LD A, (XXXX) 




GET OLD ROM NO. 


031 F 




OUT (1F),A 




TRANFER BACK 


09 




RET 




BACK TO CALLER 






i THE CALLED ROUTINE 


MUST MAKE THE 






; FOLLOWING IDENTIFICATIONS 


..YYYY 




LD HL.(YYYY) 




GET SAVED DATA 


..ZZZZ 




LD A, (ZZZZ) 




GET SAVED DATA 






; EXECUTE SUBROUTINE 


FOUND HERE 






i PERFORM FOLLOWING 


STEPS WHEN THE 






; SUBROUTINE IS COMPLETE 


AND MUST RETURN 


C3 WW 




JP BACK 




; GO TO XFER ROUTINE 


Listing 


8-7. A 


ccessing multiple ROMs (calls). 



This bank-select method is only one of many 
options which may be selected to move from one 
ROM to another; as you can see, three bytes of 
RAM (marked ZZZZ, YYYY and WWWW in 
the listings) are needed to store information 
between transfers. Although this process may 
initially seem unwieldy, a ROM-resident 
operating system in each one, together with 
cautious programming, will provide a 
remarkably transparent system expansion. 
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H01D3NN0a QHVO 39CB 03-SH1 



Figure 8-16. Bank-selected 4118 ROM/RAM. 
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Figure 8-1 7. ROM/RAM addition without bank-select 
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Completed ROM/RAM addition with power supply on board. 
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00100 


; MEMORY SIDECAR TEST TAPE (C) 1981 D. B. KITSZ 




00110 


; 






3C0Q 


00120 




ORG 


3C00H 


3C0D 2A 


00130 




DEFM 


'** LOADING 2K RAM TEST TAPE ' 


3C1C 2D 


00140 




DEFM 


'— 0. B. KITSZ, SEPTEMBER 1981 ** 


3000 


00150 




ORG 


3000H 


3000 2A 


00160 


M1 


DEFM 


i $«£s#e$e*«e*«*eee#*$?$9«£««#«e«» i 


3020 2A 


00170 




DEFM 


> ***##*****#**«#********##**#$$*$ i 


3040 2D 


001 BO 


ME 


DEFM 




IcbllNb HcALi— UNLY 


3060 2D 


00190 




DEFM 
DEFM 


1 ram" Hrnnnv flnrfl * 


30B0 54 


00200 


M3 


'THIS SCREEN HAS BEEN LOADED DIRE' 


30A0 43 


00210 




DEFM 


'CTLY FROM THE MEMORY SIDECAR. IF' 


30C0 41 


00220 


M4 


DEFM 


'ALL CHARACTERS ARE CORRECT IN TH' 


30E0 49 


00230 




DEFM 


'IS MESSAGE, AND IT HAS LOADED ON' 


3100 54 


00240 


M5 


DEFM 


'THE SCREEN NORMALLY, THEN THIS F' 


3120 49 


002S0 




DEFM 


'IRST TEST OF YOUR MEMORY SIDECAR' 


3140 4S 


00260 


MB 


DEFM 


'IS COMPLETED. BELOW IS SHOWN A ' 


3160 43 


00270 




DEFM 


'COMPLETE CHARACTER SET AVAILABLE' 


3180 54 


00280 


M7 


DEFM 


■TO YOUR TRS-BO: ' 


31 AB 20 


00290 




DEFM 


! ! 


31 CO 0001 


00300 


MB 


DEFW 


0100H 


31C2 0203 


00310 




DEFW 


0302H 


31C4 0405 


00320 




DEFW 


0504H 


31 C6 0607 


00330 




DEFW 


070BH 


31CB 0809 


00340 




DEFW 


090BH 


31 CA OAOB 


00350 




DEFW 


OBOAH 


31 CC OCOD 


00360 




DEFW 


ODOCH 


31 CE OEOF 


00370 




DEFW 


OFDEH 


31D0 1011 


00380 




DEFW 


1110H 


31D2 1213 


00390 




DEFW 


131 2H 


31D4 1415 


00400 




DEFW 


151 4H 


31D6 1617 


00410 




DEFW 


1716H 


3108 1819 


00420 




DEFW 


1918H 


31DA 1A1B 


00430 




DEFW 


1B1AH 


31DC 1C1D 


00440 




DEFW 


1D1CH 


31DE 1E1F 


00450 




DEFW 


1F1EH 


31 EO 2021 


00460 




DEFW 


2120H 


31 E2 2223 


00470 




DEFW 


2322H 


31 E4 2425 


00480 




DEFW 


2524H 


31 E6 E627 


00490 




DEFW 


2726H 


31 E8 2B29 


00500 




DEFW 


292SH 


31 EA 2A2B 


00510 




DEFW 


2B2AH 


31 EC 2C2D 


00520 




DEFW 


2D2CH 


31 EE 2E2F 


00530 




DEFW 


2F2EH 


31F0 3031 


00540 




DEFW 


3130H 


31F2 3233 


00550 




DEFW 


3332H 


31F4 3435 


00560 




DEFW 


353 4H 


31F6 3637 


00570 




DEFW 


3736H 


31FB 3B39 


00580 




DEFW 


393BH 


31FA 3A3B 


00590 




DEFW 


3B3AH 


31FC 3C3D 


00600 




DEFW 


3D3CH 


31FE 3E3F 


00610 




DEFW 


3F3EH 


3200 4041 


00620 


M9 


DEFW 


4140H 


3202 4243 


00630 




DEFW 


4342H 


3204 4445 


00640 




DEFW 


4544H 


3206 4B47 


00650 




DEFW 


4746H 


320B 4849 


00660 




DEFW 


4948H 


320A 4A4B 


00670 




DEFW 


4B4AH 


320C 4C4D 


006B0 




DEFW 


4D4CH 


320E 4E4F 


00690 




OEFW 


4F4EH 


3210 5051 


00700 




DEFW 


5150H 


3212 5253 


00710 




DEFW 


5352H 


3214 5455 


00720 




DEFW 


5554H 


3216 5657 


00730 




DEFW 


5756H 


3218 585S 


00740 




DEFW 


5958K 


321A 5A5B 


00750 




DEFW 


5B5AH 


321 C 5C5D 


00760 




DEFW 


5D5CH 


321 E 5E5F 


00770 




DEFW 


5F5EH 


3220 6061 


00780 




DEFW 


6160H 


3222 6263 


00790 




DEFW 


6362H 


3224 6465 


00800 




DEFW 


656 4H 


3226 6667 


00810 




DEFW 


6766H 


3228 6869 


00B20 




DEFW 


6968H 


322A 6A6B 


00830 




DEFW 


6B6AH 


322C 6C6D 


00B40 




DEFW 


6D6CH 


322E 6E6F 


00850 




DEFW 


6FBEH 


3230 7071 


00860 




DEFW 


7170H 


3232 7273 


00870 




DEFW 


7372H 


3234 7475 


00880 




DEFW 


7574H 


3236 7677 


00890 




DEFW 


7776H 


3238 7879 


00900 




DEFW 


7978H 


323A 7A7B 


00910 




DEFW 


7B7AH 


323C 7C7D 


00920 




DEFW 


7D7CH 


323E 7E7F 


00930 




DEFW 


7F7EH 


3240 B0B1 


00940 


M10 


DEFW 


S18DH 


3242 8283 


00950 




DEFW 


B382H 


3244 8485 


00960 




DEFW 


B5B4H 


3246 B6B7 


00970 




DEFW 


B786H 


3248 8889 


00980 




DEFW 


B98BH 


324A BA8B 


00990 




DEFW 


BB8AH 


324C BC8D 


01000 




DEFW 


BDBCH 


324E 8E8F 


01010 




DEFW 


8FBEH 



Remember also that the ROMs do not need to 
call each other directly. Instead, you may want to 
establish a lookup and transfer table in RAM, 
that acts like this : 

1. User is in BASIC. 

2. OUT 31,0 is entered to select the master 
ROM. 

3. SYSTEM is entered, followed by /12288. 

4. The master ROM (ROM #0) may be 
programmed to reset MEMORY SIZE and 
relocate a bank of patch points into RAM. 

5. The master ROM, having completed its 
work the way Level II does at power up, 
returns to a READY in BASIC. 

6. The routines are now all ready to use. 



In summary, the ROM, RAM and bank-select 
systems can extend the horizons of your TRS-80 
in unique ways. A project for people afflicted 
with cerebral palsy is developing a system 
whereby patients, doctors, or nurses need not be 
concerned if the TRS-80 crashes at some point, 
or the power is removed. Instead of loading tapes 
or fumbling with disks that may get damaged 
through handling or erratic power, these people 
need only use their bank-selected ROMs to 
reinstate and activate the machine language 
programs which drive specially made hardware. 
This hardware permits them to communicate 
with and use the computer with great ease. 

Without the bank-select feature, however, the 
8K control programs would have to be reloaded 
regularly, at a cost of time and patience, plus the 
risk of damage, loss or failure. 



Listing Continued . 
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3260 9091 


01020 




DEFW 


91 BOH 


3252 9293 


01030 




DEFW 


9392H 


3254 949S 


01040 




DEFW 


9594H 


3256 9697 


01050 




DEFW 


9796H 


3258 S689 


01060 




DEFW 


9898H 


325A 8A9B 


01070 




DEFW 


9B9AH 


325C 9C9D 


01080 




DEFW 


9D8CH 


325E 9E9F 


01090 




DEFW 


SFSEH 


3260 A0A1 


01100 




DEFW 


0A1A0H 


3262 A2A3 


01110 




DEFW 


0A3A2H 


3264 A4AS 


01120 




DEFW 


0A5A4H 


3266 A6A7 


01130 




DEFW 


0A7A8H 


3268 A8A9 


01140 




DEFW 


0ASA8H 


326A AAAB 


01150 




DEFW 


DABAAH 


326C ACAD 


01160 




DEFW 


OADACH 


326E AEAF 


01170 




DEFW 


OAFAEH 


3270 B0B1 


01180 




DEFW 


0B1B0H 


3272 B2B3 


01190 




DEFW 


0B3B2H 


3274 B4B5 


01200 




DEFW 


0B5B4H 


3276 B6B7 


01210 




DEFW 


0B7B6H 


327B B8B9 


01220 




DEFW 


0B9BBH 


327A BABB 


01230 




DEFW 


OBBBAH 


327C BCBD 


01240 




DEFW 


OBDBCH 


327E BEBF 


01250 




DEFW 


OBFBEH 


3280 C0C1 


01260 


H11 


DEFW 


0C1C0H 


3282 C2C3 


01270 




DEFW 


0C3C2H 


32B4 C4C5 


01280 




DEFW 


0C6C4H 


3286 C6C7 


01290 




DEFW 


0C7C6H 


3288 CBC9 


01300 




OEFW 


0C9C8H 


328A CACB 


01310 




DEFW 


OCBCAH 


32BC CECD 


01320 




DEFW 


OCDCEH 


328E CECF 


01330 




DEFW 


OCFCEH 


3230 D0D1 


01340 




DEFW 


0D1D0H 


3292 D203 


01350 




DEFW 


0D3D2H 


3294 D4D5 


01360 




DEFW 


0D5D4H 


32S6 06D7 


01370 




DEFW 


0D7D6H 


329B DBD9 


01380 




DEFW 


0D9DBH 


329A DADB 


01390 




DEFW 


ODBDAH 


328C DCDD 


01400 




DEFW 


ODDDCH 


329E DEDF 


01410 




DEFW 


DDFDEH 


32A0 E0E1 


01420 




DEFW 


0E1E0H 


32A2 E2E3 


01430 




DEFW 


0E3E2H 


32A4 E4E5 


01440 




DEFW 


0E5E4H 


32A6 E6E7 


01450 




DEFW 


0E7E6H 


32A8 E8E9 


01460 




DEFW 


0E8EBH 


32AA EAEB 


01470 




DEFW 


OEBEAH 


32AC ECED 


01480 




DEFW 


OEDECH 


32AE EEEP 


01490 




DEFW 


OEFEEH 


32BD FDF1 


01500 




DEFW 


0F1F0H 


32B2 F2F3 


01510 




DEFW 


0F3F2H 


32B4 F4F5 


01520 




DEFW 


0F5F4H 


32B6 F6F7 


0153D 




DEFW 


0F7F6H 


32BB FBFS 


01540 




DEFW 


0F9F8H 


32BA FAFB 


01 550 




DEFW 


OFBFAH 


32BC FCFD 


01560 




DEFW 


OFDFCH 


32BE FEFF 


01570 




DEFW 


OFFFEH 


32C0 20 


01560 


M12 


DEFM 




32E0 20 


01590 




DEFM 




3300 57 


0160D 


H13 


DEFM 


'WHEN YOU HAVE VERIFIED THAT ALL ' 


3320 43 


01610 




DEFM 


'CHARACTERS HAVE BEEN TRANSFERRED' 


3340 43 


01620 


M14 


DEFM 


'CORRECTLY TO THE SCREEN, PRESS T' 


3360 48 


01630 




DEFM 


'HE <ENTER> KEY TO CONTINUE ■ 


3380 20 


01640 


M15 


DEFM 




33AB 20 


01650 




DEFM 




33C0 2A 


01660 


H16 


DEFM 


i **************»*****»*****##***# i 


33E0 2A 


01670 




DEFM 


i eeee*e«9*#*9«9*«**ea«*e*$*«*»»e* i 


3400 2A 


01660 


MIA 


DEFM 


■ **#»**#**##**#*####*####*#*#**** i 


3420 2A 


01690 




DEFM 


i e****w#*»*****#**#*»##*G#**###*# t 


3440 2D 


01700 


M2B 


DEFM 


' TT n TTHf > "nrnn nm v 


icoiJ.Nb HUUJ-* UNLY 


3460 2D 


01710 




DEFM 


' rirtM" iirnnnv nnHT'n * 
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3471 54 


01720 


MSA 


DEFM 


'THIS SECOND SCREEN OF CHARACTERS' 


3491 20 


01730 




DEFM 


' IS FOUND IN THE SECOND GROUP OF' 


34B1 32 


01740 


H4A 


DEFM 


'2K RANDOM ACCESS MEMORY CHIPS IN' 


34D1 20 


01750 




DEFM 


' THE MEMORY SIDECAR. THE SCREEN" 


34F1 53 


01760 


M5A 


DEFM 


'SHOULD BE AS CLEAN AS THE FIRST ' 


3511 4F 


01770 




DEFM 


'ONE WITH THE EXCEPTION OF AN ODD' 


3531 47 


01780 


M6A 


DEFM 


'GROUP OF CHARACTERS PRINTED IHME' 


3551 44 


01790 




DEFM 


■DIATELY BELOW THIS LINE — ' 


3571 20 


01800 


M7A 


DEFM 


1 ! 


3575 811640 


01810 


ENTRY 


LD 


HL.4016H 


3576 36E3 


01820 




LD 


(HD.0E3H 


357A 23 


01830 




INC 


HL 


357B 3603 


01840 




LD 


[HLJ ,03H 


357D 210030 


01650 


BACKUP 


LD 


HL.3000H 


3580 11003C 


01860 




LD 


DE.3CD0H 


3583 010004 


01B70 




LD 


BC.400H 


35B6 EDBO 


01880 




LDIR 




35B8 3A403B 


01 890 


L00P1 


LD 


A,(3840H] 


35BB A7 


01900 




AND 


A 


3S8C 28FA 


01910 




JR 


Z.L00P1 


35BE CDA435 


01920 




CALL 


DELAY 


3591 2634 


01930 




LD 


H.34H 


35S3 163C 


01940 




LD 


D,3CH 
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Romplus and Other ROM Extenders 

There are simpler methods of adding ROM 
to the TRS-80, where some of the work has 
already been done for you. The Micro 80 
Computer Club of Ontario (in care of Brian 
Harron, 67-3691 Albion Road, Ottawa, Ontario 
KIT 1P2) has produced their Romplus board, 
capable of handling two 2708 IK ROMs or one 
2716 2K ROM. It fits inside the keyboard, and 
only requires soldering three integrated circuits 
in place on the board, plus sockets for the 
ROMs. 

Computer Accessory Technology (1307 Bagley 
Drive, Kokomo, Indiana 46901) has also 
developed a small board which contains a single 
2716 EPROM and an address decoder. It comes 
caseless, but has a power supply and plugs 
direcly into the TRS-80 edge-card connector. A 
set of programmed ROMs is available which 
include utilities of different kinds. 
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Personal Micro Computers (475 Ellis Street, 
Mountain View, California 94043) makes the 
REX-80 ROM extender, which is similar to the 
C.A.T. board, but comes with case and power 
supply, plus edge connector and cable. They 
also provide programmed ROMs. About $50 for 
the device, $25 for the ROMs. 

Finally, The Peripheral People (P.O. Box 524, 
Mercer Island, Washington 98040), offers the 
Memory Sidecar ROM/RAM addition, which I 
designed, and is identical to the ROM/RAM 
addition presented in this book, without any 
bank-select features. The complete unit is $149, 
and a blank board is $25. 
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Continued Listing 



3595 0604 
3597 EDBO 
3599 3A4038 
35SC A7 
359D 26FA 
359F CDA435 
35A2 1BD9 
35A4 010040 
35A7 OB 
35AB 79 
35A9 B1 
35AA 2DFB 
35AC C9 
35AD SO 
35B1 20 

20 

20 

20 

54 

20 

54 

53 



35D1 

35F1 

3611 

3631 

3651 

3671 

3691 

36 Bt 20 

36 D1 20 

36F1 54 

3711 41 

3731 55 

3751 

3771 

3791 

37B1 

3C40 

3C40 2A 

3C5F 50 

4016 

4016 7535 

3575 

00000 TOTAL 

29944 TEXT 



45 
20 
20 
20 



01950 

01960 

01970 L00P2 

01990 

01990 

02000 

02010 

02020 DELAY 

02030 L00P3 

02040 

02050 

02060 

02070 

02080 

02090 M8A 

02100 

02110 M9A 

02120 

02130 H10A 

02140 

02150 M11A 

02160 

02170 M12A 

02160 

021 SO M13A 

02200 

02210 M14A 

02220 

02230 

02240 

02250 

02260 

02270 

02280 

02290 

02300 

02310 
ERRORS 
AREA BYTES LEFT 



LD 

LDIR 

LD 

AND 

JR 

CALL 

JR 

LD 

DEO 

LD 

OR 

JR 

RET 

DEFH 

DEFM 

DEFH 

DEFM 

DEFH 

DEFM 

DEFM 

DEFH 

DEFH 

DEFM 

DEFH 

DEFH 

DEFH 

DEFM 

DEFH 

DEFM 

DEFH 

DEFM 

ORG 

DEFM 

DEFM 

ORG 

DEFW 

END 



BACKUP 

DELAY 

ENTRY 

L00P1 

L00P2 

LOOPS 

Ml 

M10 

H10A 

H11 

H11A 

H12 

H12A 

M13 

H13A 

M14 

M14A 

H15 

M16 

MIA 

M2 

M2B 

H3 

H3A 

M4 

H4A 

H5 

M5A 

H6 

MBA 

M7 

H7A 

HB 

HBA 

H9 

M9A 



357D 
35A4 
3575 
35BB 
3599 
35A7 
3000 
3240 
3631 
3260 
3B71 
32C0 
36B1 
3300 
36F1 
3340 
3731 
3380 
33C0 
3400 
3040 
3440 
3080 
3471 
30C0 
34B1 
3100 
34F1 
3140 
3531 
3180 
3571 
31C0 
3581 
3200 
35F1 



01850 
02020 
01810 
01890 
01970 
02030 
00160 
00940 
02130 
01260 
D2150 
01580 
02170 
01600 
02190 
01620 
02210 
01640 
01660 
01680 
00180 
01700 
00200 
01720 
00220 
01740 
00240 
01760 
00260 
01760 
00280 
01800 
00300 
02090 
00620 
02110 



02010 

01S20 02000 
02300 02310 
01910 
01990 
02060 



B,4H 

A,(3B40HJ 

A 

Z, LOOPS 

DELAY 

BACKUP 

BC.4000H 

BC 

A,B 

C 

NZ.L00P3 



' - MUCH IS THE ACTUAL BLOCK' 

■ OF MACHINE CODE THAT IS RUNNING' 
'THIS TEST PROGRAM. TO EXIT THIS' 
• ROUTINE, YOU MUST PRESS RESET. 1 
'TO REPEAT THE TEST SEQUENCE, PRE' 
'SS THE <ENTER> KEY. ' 



'THE UNUSUAL LINES SEEN HERE ARE ' 
'A REPRESENTATION OF MEMORY SPACE' 
'USED BY THE TRS-80 TO CONTROL TH' 
'E DISK DRIVES AND CASSETTE PORT:' 



3C40H 

'** LOADING 2K RAH TEST TAPE COM 1 

■PLETE. CONTROL TAKEN BY TEST **■ 

4016H 

ENTRY 

ENTRY 



A Front Panel Monitor 

The first personal computers were a hobbyist's 
dream and a user's nightmare. These large boxes 
of electronic boards were programmed by hand, 
one byte at a time. The operation of the 
processor was stopped, an address was selected, 
and a byte programmed — all by using nearly 30 
switches. 

The TRS-80 is a far cry in size, speed, power, 
and convenience from these early machines (but 
don't forget that 'early' means 1974!). Yet there 
was an advantage in these early machines that 
the TRS-80 and its kin don't have: the front 
panel display. The front panel not only contained 
the multiple switches, but also a bank of LEDs so 
the user could view the contents of memory, 
registers, etc. (see Photo 8-2. ). 

The front panel is not an entirely obsolete 
concept, and can be remarkably valuable when 
your machine language programs sprint for the 
exit when you're not looking. Since the front 
panel visually monitors addresses and data, it 
provides somewhat of a window opening on the 
computer's activities. 

The front panel can tell you if the machine is 
caught up in a deadly tight loop, if it is still 
processing (have you ever waited while the 
computer sorted string data? ), or if it is operating 
in the area you expect it to. You can follow 
peripheral accesses like printers and disk, sound 
output routines and special devices you may have 
created. 

Figure 8-18 presents the circuit for the micro 
front panel. It is no more than a group of latches 
which are activated by certain conditions - you 
may select any combination of input, output, 
read or write signals to trigger the LED displays. 
16 LEDs monitor the address, and eight monitor 
the data. 

The latches are triggered on an upswing of any 
signal line that is switched into the select gate; 
the gate may be switched off entirely, leaving the 
last latched address displayed on the LEDs. 

Ideally, the front panel can be created from 
subminiature, 'grain of wheat' LEDs, and 
mounted directly in the TRS-80 case and 
soldered in place. Alternatively, it may be 
connected when needed by a standard 40 
conductor cable. Method of construction is not 
critical, and can use soldering and wire wrap. 
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Phoio 8-1. DEC front panel 
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Photo 8-2. Micro front panel. 

Micro front panel monitor shows data and address lines from 
read, write, input, or output conditions. 



When using the micro front panel, you'll notice 
that much of the activity, particularly memory 
reads, run by very fast. It can't be helped. 
Because the TRS-80 uses dynamic memory 
which must be refreshed every few thousandths 
of a second (see description earlier in this 
chapter), the instruction clock cannot be 
stopped. Thus, you'll have to get used to the fast 
operation, noting from the intensity of the LEDs 
the frequency with which an area of memory is 
accessed. The monitor is remarkably useful when 
running diagnostic routines, because it points out 
whether there are any obvious signal line flaws. If 
the diagnostic program is a tight loop (most are - 
see chapter 10), then the activities of the 
computer's signal lines will become very obvious 
on the micro front panel. 

In any case, it's easy to build and nifty to watch 
- very instructive to see how the computer 
accesses disks, for example, or how one data line 
pulses during cassette input/output. 



Micro front panel can be plugged directly into the edge card or 
put at the end of a connector cable, as shown here. 
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Figure 8-18. Micro front panel. 
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Keeping It Safe: Mass Storage 

Mass storage for computer programs and data 
has evolved from the days of punched paper tape 
and punch cards to present systems involving 
magnetic disk storage and bubble memories. 

For microcomputer users, mass storage 
presents a unique problem: slow and apparently 
unreliable tape systems are inexpensive but 
frustrating, whereas fast disk-based systems 
seem transparent, trouble free, and expensive. 
Both of these generalizations border on myth. 

What are the true advantages and 
disadvantages of the competing systems? This 
chapter will cover them in some detail, but 
briefly, here they are: 

1. Cassette tape is a slow to medium speed 
storage medium (500 bits per second is 
normal for the TRS-80, with systems capable 
of transferring data at more than 3000 bits 
per second). 

2. Tape is an inexpensive storage medium 
(3/1000 of a cent per bit), and is available 
across the counter. The hardware is 
pre-configured on the TRS-80, and the 
operating system (such as it is) is in ROM. 
Total system cost, including several boxes of 
blank cassettes, is under $100. 

3. Tape is a reliable storage medium, where 
good materials are used and care is taken. In 
a properly aligned system using low-noise, 
high-output cassettes, my own tests showed 
an average of one loading failure in 2.5 
million bits. 



4. Higher speed tape loaders add to the cost 
of the tape electronics, reducing their 
attractiveness, but increasing their speed 
and often their reliability where marginally 
recorded tapes are present. 

5. Tape storage is sequential access, except 
where special digital tape systems are used. 
A program, once in the process of being 
loaded, is not tried again and again should a 
bit failure occur. Data storage problems are 
compounded, with double-dumping almost a 
requirement, and sequential conception and 
operation of programs essential. 

6. The tape operating system is an essential 
part of the language, except where outboard 
devices (such as Fastload and similar 
systems) are used. Thus, it cannot be 
changed without adding a non-transparent, 
RAM-resident patch to the operating 
system. 

7. Disk systems are capable of fast transfer 
rates (125,000 bits per second is possible), 
but the orientation towards records, 
directories, and other internal checking and 
referencing systems creates an effective 
transfer rate of 10,000 bits per second or less. 

8. Disk systems contain built-in error 
checking and re-try routines. Thus, 
although data transfer errors occur as 
frequently as errors on cassette tape (if not 
more so), the random-access and retry 
capabilities make them appear error free 
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except where disks have been physically 
damaged, written over in error, or 
demagnetized. The apparent reliability is 
very high. 

9. Disk systems are comparatively costly in 
their original hardware configuration, their 
operating systems, and their medium. 
However, the storage cost of the medium is 
comparable to that of cassette tape, at about 
2/1000 of a cent per bit. The initial 
hardware investment is higher, requiring 
disk control ($300 for an expansion box or 
similar controller) and the drive ($350 or 
more, with quality increasing with price), 
and an operating system ($25 to $250, again 
depending on needs). An initial investment 
in disk storage, including a box of disks, can 
begin at $750 and end in the multiple 
thousands. 

10. System flexibility is increased greatly, as 
the disk's operating system and BASIC 
language additions overlay each other as 
needed, and appear almost transparent to 
system operation. However, the plethora of 
disk operating systems and approaches 
limits the interchangeability of information 
from one TRS-80 to another with a different 
operating system. 

11. Intermediate and hybrid systems are 
available that encompass some of the 
features of both standard tapes and disks. 
Foremost among these is the Exatron 
Stringy-Floppy endless-loop tape cartridge 
system. Its operating system is 
ROM-resident, its transfer rate is 7,200 bits 
per second. 

12. The Stringy-Floppy is probably the most 
reliable mass storage system under adverse 
environmental conditions, putting it above 
tape and far beyond the sensitive (some say 
temperamental) disk systems. This aspect 
more than any other probably justifies its 
consideration as serious mass storage. Based 
on hi-tech, laboratory models, the ESF is a 
scaled-down scientific storage system. 

13. Like tape, access using the ESF is 
sequential, but the endless loop makes 
pseudo-random access possible. With short 
tapes and programs less than 8K bytes, 
actual load/save time is faster than disk. 

14. Cost of this system is less than disk 
($250 for the hardware, $3 for the medium, 



an endless-loop 'wafer'), and the cost of 
storage is less than all other complete 
systems (about 1/1000 of a cent per bit). To 
be competitive with dropping disk prices, I 
expect to see the hardware cost drop. 

15. Although less fragile than disks (and 
higher in quality of the magnetic surface), 
the ESF wafers, because they use thin tape 
on a tiny, endless-loop hub, can be damaged 
by the tape binding or pulling from the 
housing. Unlike the larger cassettes, the 
tape cannot be successfully reinstalled in the 
housing, and unlike disks, the undamaged 
material on the wafer cannot be recovered. 

This chapter will present a tour through the 
available mass storage systems (except tape - see 
Supplements to Chapters 3(?) and 6(?)), describe 
the construction of a paper tape reader, and 
present the construction and operation of a tape 
storage device using 8-track cartridges. 

Disk Drives 

Disk drives come in a variety of sizes, shapes 
and formats. Among those are floppy disks in 
5-inch and 8-inch sizes; removable and 
permanent hard disks; and permanently housed 
Winchester drives. Miscellaneous variants of all 
kinds are for sale or under development. 

The most popular system for the TRS-80 is the 
5-inch floppy disk system. The drive contains a 
platter which spins the magnetic disk inside its 
cardboard sleeve, a record/playback head to read 
the data, and a stepping motor to move the head 
from concentric track to track. The data is 
recorded using sharp digital pulses without any 
sort of audio recording considerations such as 
high-frequency bias. DC 'trim erase' is used to 
remove previously recorded data just ahead of 
the write head. 

A single indexing hole near the center hub is 
used to inform the drive electronics and control 
software of the disk's position inside the paper 
sleeve. Other than this hole and a write-protect 
notch in the top edge of the paper case, there is no 
other information available to the drive and 
control software from a blank disk. It must be 
formatted, which is the process of embedding 
magnetic information on the disk for later use by 
the disk operating system. 

The information needed for the original Radio 
Shack specifications included the magnetic 
outlining of 35 concentric tracks on the disk, and 
the separation of those 35 tracks into ten 
discontinuous bands each, called sectors. 
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TRACKS 1.2 35 



DIRECTION OF ROTATION 



Figure 9-1. Disc and disk system format 



Details of the system by which information is 
recorded on the disk can be found in the 
TRSDOS 9 Disk BASIC Reference Manual, and 
TRS-80 Disk 9 Other Mysteries. In summary, 
the original Radio Shack specifications called for 
a disk containing 35 tracks of 10 sectors of 256 
bytes each, for a total of 83,060 available bytes 
(89,600 are actually recorded, but several 
thousand are reserved for directory and other 
information - again, see the references above for 
details). 

Drive manufacturers and software authors 
immediately began modifying the Radio Shack 
standards. 40, 77 and 80 tracks could be used, 
and nearly a dozen different disk operating 
systems (DOS) made their appearance: the 
original TRSDOS from Radio Shack (versions 
through 2.3 now issued); NEWDOS, an updated 
and corrected version of TRSDOS, sold by 
Apparat; NEWDOS/80, a complete re-write 
incompatible with the others; VTOS (now issued 
through versions 4.0), written by the original 
author of TRSDOS; MicroDOS and its successor 
OS/80, a stripped-down, efficient, minimal DOS 
which is growing larger and hence less attractive; 
DBLDOS, a Percom entry that operates its 
double-density (80-track) hardware option; 
DOSPLUS in single- and double-density 
versions, a wide-ranging program by Micro 
Systems Software; CP/M, supposedly a standard 
DOS for microcomputers, but available only in 
modified form for the TRS-80; and many special 
operating systems to load and run protected 
software. 

Choosing a disk operating system is outside the 
range of this book, to be sure. Incompatibilities 
ride rampant over the bytes of the TRS-80 
computer; the consistent, convenient, accessible 
Level II ROM gives way under disk control to the 



whims of software authors and entrepreneurs, 
good and bad. It might seem like I'm knocking 
DOSes; I'm not, because it's truly a customizer's 
dream. But a problem arises when trying to deal 
with customization: to begin with, a disk 
operating system is a kind of customization. 
Hence, it becomes almost impossible to 
customize one further without being forced to 
provide versions for every popular DOS. There 
are too many, and they change quickly ... to 
patch them invites problems, ill will, and 
frustration. 

On the other hand, a disk system is ideal for 
customizing the TRS-80, because, once you have 
selected the operating system, you may modify 
and change it, making it your own. In a sense, 
that is how Apparat created NEWDOS - as a 
series of patches and improvements to TRSDOS, 
and in fact it originally required that disk users 
already own a copy of TRSDOS. 

Inside A Disk Drive 

The insides of a disk drive seem incredibly 
simple. In fact, they are. It is only the precision 
of alignment needed and a few expensive parts 
which bring the cost so high. The drive consists 
of an electronic control board which is capable of 
communicating with the controlling computer, in 
this case the TRS-80, through a disk controller 
chip (FDC - see below). There is a motor which 
spins the disk, and in most inexpensive drives 
this motor is connected through a drive belt to 
the disk hub. The motor speed of 300 rpm must 
be accurate to within five percent; three percent 
deviation from normal is reasonable, and most 
drives are capable of a 1.5 percent long-term 
deviation. The disk is inserted in the housing and 
held in place by a cone and pressure plate which 
fit around the hub, and clamp gently but firmly 
to the disk's center area. 

When the door to the drive is closed, the 
pressure plate moves into place, and the disk is 
brought into contact with the read/write head. A 
properly seated disk will present the indexing 
opening to a light sensor, so that as it spins inside 
the paper envelope, the index hole will open the 
light beam as it passes by. 

A stepping motor is capable of moving 
precisely to one position on its axis, on command. 
This type of motor is used to position a magnetic 
read/write head on the disk track to be read. The 
motor is fast and precise, and the assembly which 
it moves is carefully machined so there is 
virtually no up-down play in the head. Opposite 
the head is a pressure pad which forces the disk 
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to maintain contact with the head, albeit 
separated from the head by a few microinches. 

The head itself is usually of the glass-ferrite 
variety; it has an extremely smooth, highly 
polished surface that will not damage the disk, 
and a very long life that exceeds 20,000 hours of 
continuous head-to-disk contact. It is capable of 
handling the high write currents generated by 
the digital circuitry, and virtually immune to 
electronic noise in its vicinity. 

In the TRS-80 system, the disk drive itself 
accepts and sends certain pieces of information. 
They are: 

1. A 4-bit drive select indicator sent to the 
drive; only the drive hard-wired to accept 
this signal will respond. In the TRS-80 
system, this wiring is done in the cable itself. 

2. A motor-on signal, which turns on the 300 
rpm hub motor. 

3. A track-to-track stepping signal and a 
stepping direction signal. 

4. A write-enable signal and a stream of 
written data. 



5. A stream of written data sent by the 
drive. 

6. A write-protect signal to prevent writing 
to write-protected disks. Most drives will 
not respond to a write signal, and this 
write-protect signal is sent so the software 
can report a write-protected condition. 

7. An index pulse to indicate where the disk 
is currently located in its rotation. 

8. A track-zero indicator to identify when 
the disk head has reached the outermost 
track on the disk. This is used to locate 
tracks, relocate tracks or reposition the head, 
and on initial access to identify the head 
position. 

Except for the drive-select signals, the disk 
controller chip is responsible for managing all 
these lines. In the TRS-80, a type 1771 controller 
is used, manufactured by Western Digital. A 
complete data sheet is provided with the 
Expansion Interface service manual from Radio 
Shack. 




The author at work. 






206 



Chapter 9 



The Floppy Disk Controler 



This controller has eight data input/output 
lines (DALO to DAL7) to the computer, an 
interrupt output to signal its need for service 
(INTRQ), read and write enables (RE and WE), 
and a two-bit address select (AO and Al). These 
last are used to select the register that will send or 
receive data on the DAL lines: 



AO 



RE 



WE 



Status Register 
Track Register 
Sector Register 
Data Register 



Command Register 
Track Register 
Sector Register 
Data Register 
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Photo 9-1. Pictorial tour (6) of disk drive. 

Front door of disk drive controls mechanism to steady the disk as 

well as a switch to indicate that the door is closed 
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Circuit card contains disk read/write circuitry, motor stepping 
control, and computer interfacing. Computer connector and 
termination resistors are seen at lower right 



In the TRS-80, the chip is always selected (CS) 
because the buffering of data is taken care of by 
Z33, Z37 and Z38 in the expansion box. The Data 
Request signal (DRQ) is not used, nor are the 
three-phase motor signals (PH3 and 3PM), and 
the track-greater-than-43 signal (TG43). These 
signals would be present were a more 
sophisticated disk drive capability intended by 
Radio Shack in future versions of the TRS-80. 

The clock input is provided by the separate 
oscillator in the expansion interface. Three 
voltages are needed (+12, +5, and -5), plus 
ground. 

Test, disk initialization (DINT), and 
write-fault lines (WF) are not used, nor are the 
infamous external data separation (XTDS) and 
external data clock (FD CLOCK) lines. Disk 
data are separated by clock pulses, and high 
accuracy demands unfailing differentiation 
between the clock pulses and the data pulses. 
The Percom data separator plugs into the 
controller chip socket and makes use of XTDS 
and FD CLOCK. 

The head-load output (which determines 
whether the read/write head is in place against 
the disk) is not used, because software controls 
the timing between motion of the read-write 
head. Head-load timing (HLT) and READY are 
both connected via external logic to the TRS-80, 
where software determines when the drive and 
read/write head should be ready to read or write. 
The remaining disk controller signals lead to and 
from the disk drive itself, and are identical to 
those listed in the description of the drive signals. 
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Opposite side from control card is the drive motor with speed 
strobe disk, and a window revealing the shaft of the head 
stepping motor. 
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Inside a Disk Drive 
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Close-up of read/write head and pressure pad. White square is 
glass ferrite head surface, vertical stripe is the head's read/write 
surface. Pressure pad moves into place when the disc 's front door 
is closed 



Removing the control circuit card reveals a heavy cast frame to 
hold the disk in place. In center is the cone that fits through the 
disk; to the right is a pressure pad 



■Lr*n 



£K 



■ 




positioning sensor. Index hole of a disk allows light to 
r jED emitter to sensor (top center). '. 
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The drive with a disk inplace. Cone fits through disk and clamps 
it in place. Head and index hole light emitter are on the other side 
of the disc; pressure pad and light sensor are on this side. 



'.tea 

Hefty disk drive power supply handles motor drive current and 
powers the electronics. 
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A Heavy Dose of DOSes 

On the software side, the number of disk 
operating systems for the Model I continues to 
increase. Most include 'Level III BASIC, the 
usual copying and formatting capabilities, but 
have been expanded to include more than that. 
For a complete description of the features of 
competing DOSes, refer to the March 1981 
issue of 80 Microcomputing. Among the special 
features of the most prominent DOSes: 

TRSDOS. AUTO, ATTRIB, CLOCK, 
COPY, DATE, DEVICE, DIR, DUMP, KILL, 
FREE, LIB, LIST, LOAD, PRINT, PROT, 
RENAME, TIME, VERIFY. Also BASIC, 
BASIC2, DEBUG, TRACE. Level III BASIC 
functions. Details are found in the TRSDOS 



manual, and other DOSes include all of these 
commands in some way or other. 



A Garden Full of Varieties 

The available variety of disk drives is 
growing. Not only are the capabilities of 
standard 5-inch drives being stretched (to run 
40, 77 and 80 track densities), but 8-inch 
systems and hard-disk systems are being 
introduced for the lowly TRS-80. Among them: 

Manufacturer Model/Type Price Comments 



Minifloppy [5-inch] Disc Systems 



Access 
Aerocomp 



CPU Shop 
HPI 

Hicropolis 

Percom 

Partec 
Shugart 

Siemens 

Tandon 

TEAC 

Vista 



AFD-1D0 $315 40 tracks; Tandon? 



40-1 
80-1 
BO-2 

160-2 



CCI-100 
CCI-200 



B/51 



B/91 



$350 
$460 
$460 

$600 



$315 
$430 



$320 



$425 



MCP1027 $300 
MCP1037 $700 
HCP1 027-2 $440 
MCP1 037-2 $800 



TFD-100 
TFD-200 



SA-400 
SA-410 



$350+ 
$650+ 



$380 



$330 
$340 



FDD 100-5 S275 
$... 



$300 
$400 



V-80 $400 

V-800 $600 

V-8B00 $775 



40 tracks J double-density 
80 tracks; double-density 
40 tracks; double-sided; 
double density. 
80 tracks; double-sided; 
double density. 

40 tracks; Percom? 
80 tracks; Percom? 

40 tracks; 5 ms track 
-to-track; auto-eject; 
double-density heBd. 
80 tracks; 3 ms track 
-to-track; auto-aject; 
double-density heed. 

35 tracks, single head 

35 tracks, dual head 

77 tracks, single head 

77 trBcks, dual head 

40 tracks 
77 tracks 



35 tracks 
40 tracks 

40 tracks, double density 

40 tracks 

40 tracks 
80 tracks 

40 tracks 
80 tracks 
160 trecks 



NEWDOS+. Adds COPY, JKL screen 
print, DIRCHECK directory verification, 
LMOFFSET tape load offset module, 
EDTASM with modifications, SUPERZAP 
for modifying disk contents, LEVEL 1 located 
in RAM, DISASSEM, LV1DSKSL disk 
save/load for Level I. CMD"DOS 
COMMAND NAME" to execute from BASIC, 
and several commands to re-enter BASIC 
from DOS. 

NEWDOS/80. CHAIN, HIMEM 
protection from DOS, JKL, MINIDOS 
don't-distrub-memory DOS, MDBORT for 
killing MINIDOS, PDRIVE setup for 
multiple drive types, PURGE for killing file 
groups, SYSTEM to create special commands, 
SUPERZAP, LMOFFSET, LEVEL 1, 
ASPOOL print spooler, DIRCHECK. 

VTOS. BOOT software reset, BUILD a 
group of auto-excute programs, CHAIN to 
execute them, MEMORY, PURGE, RUN for 
non-VTOS systems, SYSTEM , XFER disk 
copy program, PATCH disk modification 
routine, VTCOMM communications utility, 
KSR terminal program, ROUTE for changing 
the destination of data, SET for a user device 
program, SPOOL, RESET to cancel device 
setup, LINK for devices, FILTER to be used 
with device routing, ALLOC setting up disk 
space in advance. 

DOSPLUS. Adds BOOT, BUILD, CLEAR 
a directory file, DO group of auto-exeute 
programs, FORMS to set up the printer driver 
, a different variant of FREE, PAUSE for user 
input in auto-execute routines, RS232 for a 
report on that status, PURGE, DISKZAP for 
modifying disk information, CLRFILE for 
zeroing a file, COPY1 copying utility, 
CRUNCH space compression for BASIC, 
TRANSFER program copier. 

ULTRADOS. CLEAR for zeroing 
memory, DEAD for zeroing memory, 
TOPMEM for setting DOS-protected 
memory, CMD"C" compression routine, 
CMD"DOS COMMAND NAME" which 
executes from BASIC, CMD"0" file buffer 
allocation, CMD"X" to return to BASIC from 
DOS, cross referenced listing of variables and 
line numbers, renumbering from BASIC, 
shorthand command keystrokes. 
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The Exatron Stringy-Floppy 

In between tape systems and disk systems is an 
unusual device. I only say 'in between' because 
the name Stringy-Floppy implies that it 
somehow is a tapelike version of a floppy disk 
device. In fact, it is not, for two major reasons: it 
is a unique, high reliability, high endurance 
storage medium; and it does not (at least in its 
TRS-80 configuration) contain formatting, 
sectoring, or record-keeping of the type used for 
disks. 

The Exatron Stringy-Floppy (ESF) consists 
of a small DC motor which uses a tiny plastic belt 
to drive a capstan, exactly as in a cassette player. 
The motor's speed, however, is set to 10.5 inches 
per second, quite a bit faster than cassette, 
8-track, or even open-reel. Thus, even though 
the tape itself is only 1/16 of an inch wide, 
reasonable data recording can be expected. 

In the TRS-80 version, the ESF does not use 
any standard method of recording. A separate 
sequence is used to prepare, or 'verify' an 
endless-loop tape wafer than that which is used 
to record data. Both methods use a variety of 
bi-phase recording, in which the bit being read or 
recorded depends on the polarity of the bit just 
written or read. 






:mm 



Photo 9-2. Pictorial tour (6) of ESF system. 

Exatron Stringy-Floppy placed next to Microconnection modem. 
Both are compact, light devices. 



This makes the ESF reliable in spite of a motor 
speed which varies more than ten percent in 
either direction of its ideal speed. It also means 
the ESF can work under harsh conditions which 
might otherwise throw a standard clock/data 
system far off. 

Programs are recorded on the ESF in a 
continuous stream, preceded by a leader and 
followed by information to assist the software in 
locating the next available blank program space. 
Programs and data may be read in any order, but 
must be written in ascending numerical order. 

The ESF operating system is contained in a 
read only memory which resides in the 
unassigned memory area on the Model I (3000 to 
37C0); thus, it is always available and relatively 
crash-free. It does use a few bytes of RAM, 
however, and must also patch into the Level II 
BASIC parameters in low memory. 

The wafer itself is available only from 
Exatron, and is based on the wafers used in 
industrial applications. It consists of a length of 
high-output digital recording tape, highly 
polished. This is wound on a small hub, 
lubricated, and spliced into an endless-loop. A 
reflective splice is used to determine end-of-tape 
(EOT/BOT), and is viewed through a window at 
the top of the wafer. 

The wafers may be write-protected by affixing 
a reflective-tape dot on the wafer. This is read by 
the operating system before the drive is 
activated. The ESF operating system consists of 
these commands: 

@LOADx Load a program; x is the program 
number, and is optional. An error in the load 




ESF 'rubber band' drive is not as reliable as disk drives, but 
software is capable of handling greater variations in speed. 
Small DC motor replaced by a direct-drive type in later versions, 
say Exatron officials. 
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Fastload, TC-8, and Other Systems 



terminates the process and the error (parity or 
checksum) is reported to the user. 

©SAVEx Saves a BASIC program; the x is 
the program number, and is required. The 
program is verified, and any saving errors are 
reported. 

@SAVEx,r,s,t Saves a block of memory; x is 
the program number, r is the starting address, 
and s is the length of the block. These are 
required. The t is an optional entry address. 
All numbers are in decimal. The block is 
verified, and any saving errors are reported. 

@NEWx Verifies a wafer. When x is used, 
the wafer is cleared and verified from that 
program to the end splice. Available byte 
count is reported. 

Fastload, TC-8, and Other Systems 

Most other alternatives to disk systems involve 
using standard cassettes for high-speed saving 
and loading. Among these are Fastload, 
manufactured by Personal Microcomputers, 
Inc.; TC-8, or the 'Poor Man's Floppy', made by 
JPC Systems; and the Beta-80, made by Meca 
Technology. 

The advantage to the standard cassette is 
simple: cost and availability. Unlike disks, they 
are able to take some measure of abuse, and can 
be replaced without regret over the expense. And 
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Control card ofESF contains drive electronics, tape read/write 
circuitry, and 2716 EPROM containing the ESF operating 
system. Power supply is underneath the card. 



unlike Exatron wafers (or disks, for that matter), 
they can be purchased if necessary in the local 
grocery. Furthermore, cassette tape technology 
has progressed further than disk technology, 
providing better surfaces, adhesion, and 
signal-to-noise ratio. Disks are still in the dark 
ages of reproduction compared to audio tape. 

Fastload is a ROM-based operating system 
combined with a hardware detection and shaping 
circuit. A modified CTR-41 is used, where the 
fast-forward button and play button can be 
locked down. The circuit then can read a 
standard 500-baud tape in the fast-forward mode 
quite reliably at about 8000 baud. Debounce, 
audible beep, and key repeat are included with 
the operating system. 

Although I have not examined the schematics 
for Fastload, its carefully designed circuit board, 
with voltage regulator heat-sinked to the case, 
attest to a cautious, probably over-designed 
system. The loading system is put into operation 
by typing SYSTEM (ENTER), /12288 
(ENTER); optional debounce/beep/repeat can 
be added as well. 

When in operation, Fastload uses the single 
LOAD command in Level II, and is compatible 
with disk-based computers by using a SYSTEM 
call. The 500-baud load and save are left 
undisturbed. Fastload is well-designed, and 
reasonably reliable. If your original tapes have 
audible 'bumps' when played at high speed, 
however, they may not load easily with this 
system. Commercial tapes, or those recorded by 
the user on virgin cassettes, load easily and 
extremely fast. 'Bumpy' tapes, however, do not 
load well, and have to be re-recorded. 

One of the other disturbing features of 
Fastload is its tendency to give a 'READY' 
message even when a BASIC program has been 
loaded incorrectly. Granted, it is almost 
impossible to be sure a BASIC program has 
loaded well because, in its normal CSAVE 
format, no checksums have been provided. But 
the user should be sure to list the program before 
expecting it to run. SYSTEM loads, on the other 
hand, present checksum error messages on bad 
loads. Fastload costs $188 assembled; a modified 
CTR-41 is $95. 

TC-8, or the Poor Man's Floppy, both saves 
and records at high speed. It is provided in kit 
form; assembly can be completed in a few hours. 
Like Fastload, the TC-8 plugs into the edge 
connector, but the software is RAM-resident. 
The standard CTR-80 tape recorder is used, and 
a two-wire swap is shown to make the CTR-41 
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Fastload, TC-8, and Other Systems 
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Photo 9-3. Fastload device. 



Instead of a small heat sink. Fastload power supply regulator is 
sinked to the entire metal case. Insulators around regulator 
show attention to detail. 
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P/ioto 9-4. Fastload circuit card 



Circuit card for Fastload shows extremely conservative design, 
with careful attention to grounding and possible noise sources. 
DIP resistor package is used in place of separate resistors, and 
the operating system is contained in a 27 16 EPROM. Since less 
than IK of the EPROM is used for the operating system, the 
remainder may be programmed by the user with utilities. 



run properly (its high current tended to fuse 
motor relays together on the TRS-80). 

Since it is both a record and save device, the 
TC-8 contains fifteen separate commands, 
including SAVE (BASIC programs only) and 
PUT (machine language blocks); LOAD BASIC 
programs next or by name; LOAD? for 
verification; LOADN to position the tape; 
comparable GET commands for machine 
language programs; RUN as a load-and-go 
command; RSET for cassette motor on; OPEN, 
CLOSE, PRINT, and INPUT for file 
management; and KILL to eliminate file 
management. 

The software can be reconfigured, relocated, 
and stripped to a memory-saving bootstrap 
version. The TC-8 is provided with extensive 
documentation which is clear and literate, 
providing examples, a sample program using the 
OPEN, PRINT#, INPUT#, and CLOSE 
commands, along with recommendations, 
suggestions, and warnings (plus sympathy!) 
about the problems of transferring some 
commercial machine-language software to the 
TC-8. 

The circuit is quite simple, but well designed 
and accurate; the capabilities of this elegant 
circuit comes from the software. The 
construction manual provides soldering 
suggestions and explanations, recommendations 
on the soldering iron to purchase, and drawings 
of properly soldered connections. For 
convenience, all work is done on the underside of 
the board; correct placement and orientation of 
parts is emphasized. Two-color layouts of the 
board are provided on every page, along with a 
checklist of each step. These are some of the 
finest assembly instructions I have seen for a 
project. 

When complete, the unit loads and saves at 
2500 baud on off-the-shelf cassettes. The 
company recommends certain brands, and also 
sells the brand JPC products uses. All signals to 
the tape player are non-critical, and the loading 
routine will accept signals over most of the 
audible, undistorted output spectrum of most 
cassette recorders. TC-8 costs $90 in kit form. 

The Beta-80 is a tape storage system patterned 
after professional digital tape devices. Although 
a standard digital cassette is used, the Beta-80 is 
configured something like a disk, with directory 
and fast access. Fast forward and rewind are 
automatically controlled by the RAM-resident 
operating system, and the search speed is 100 
inches per second. 
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High-Speed Cassette Loading 




Photo 9-5. TC-8 tape system. 

TC-8 tape system attaches to edge-card connector and cassette 
recorder to provide high-speed record/save of programs. Photo 
courtesy JPC Products Company. 
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7000H 




; TOP OF MEMORY - RELOC. 
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######### 
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00250 


WRITE-BYTE 


SUBROUTINE. 


BYTE IS ASSUMED IN C REGISTER 
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00270 












7000 


0608 


00280 


(RITE 


LD 


B.B 




; NUMBER OF BITS TO WRITE 


7002 


C5 


00290 




PUSH 


BC 




: SAVE BITS OF BYTE 


7003 


0620 


00300 




LD 


B.20H 




; GET A DELAY VALUE 


7005 


10FE 


00310 




DJNZ 


5 




: AND DELAY 117 USECS 


7007 


C1 


00320 




POP 


BC 




; AND RESTORE BITS 


70DB 


CD1470 


00330 


VLOOP 


CALL 


TIHEX 




i WRITE TIMING BIT 


700B 


CB11 


00340 




RL 


C 




: ROTATE BIT INTO FLAG 


700D 


17 


00350 




RLA 






; ROTATE FLAG INTO A 


700E 


CD3670 


00360 




CALL 


BITEX 




i WRITE BIT TO TAPE 


7011 


10F5 


00370 




DJNZ 


WLOOP 




; DO IT TOTAL OF 8 TIMES 


7013 


09 


00380 
00390 




RET 






; BACK FROM WRITE ROUTINE 
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######### 
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WRITE TIMING 


BIT POSITIVE-NEGATIVE TO TAPE 
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SSSSSiS 


######### 


tilt 
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00430 












7014 


C5 


00440 


IMEX 


PUSH 


BC 




; SAVE B ON STACK 


7016 


3A3D40 


00450 




LD 


A,t403DH] 


: GET SCREEN INFORMATION 


7018 


E6FC 


0046 




AND 


OFCH 




; MASK OUT LOW TWO BITS 


701A 


F601 


00470 




OR 


1 




; SET LOWEST BIT 


701C 


D3FF 


004B0 




OUT 


tOFFHJ 


,A 


: WRITE BIT TO TAPE 


701 E 


0607 


00490 




LD 


B,07H 




: TIMING VALUE @ 1 .77 MHZ 


70S0 


10FE 


00500 




DJNZ 


$ 




J IS EQUAL TO 67 USECS 


7022 


E6FC 


00510 




AND 


OFCH 




; MASK OUT LOW TWO BITS 


7024 


F602 


00520 




OR 


2 




; SET NEXT LOWEST BIT 


7026 


D3FF 


00530 




OUT 


tOFFH) 


,A 


; WRITE NEG. BIT TO TAPE 


7028 


0607 


00540 




LD 


B.07H 




; TIMING VALUE 8 1 .77 MHZ 


702A 


10FE 


00550 




DJNZ 


S 




; IS EQUAL TO 64 USECS 


702C 


E6FC 


00560 




AND 


OFCH 




; MASK OUT LOW TWO BITS 


702E 


D3FF 


00570 




OUT 


(OFFH) 


,A 


: WRITE NEUTRAL BIT 


Listing 9-2. 


High-spee 


d tape loading 


routine. 







Loading is at 4000 baud (tape running at 5 
i.p.s.), twice the speed of the TC-8, but about half 
that of the Exatron Stringy-Floppy and 
Fastload, but access time (using the directory) is 
less than a minute for more than a half megabyte 
of stored programs. 

Commands are LOAD in the form of load, load 
and run, and load array information; SAVE for 
programs and arrays; MERGE for append (not a 
true merge) or append and run; and KILL to 
delete a program or an array. Other commands 
operate within the various RAM-resident 
systems. 

The Beta-80 uses a reliable Phi-deck drive, 
and has impressive features. However, as of this 
writing, users report little support from Meca for 
converting and saving machine language 
programs on the Beta-80. The Beta-80 costs 
under $300. 



High-Speed Cassette Loading 

Speeds higher than 500 baud are achievable 
entirely through software, and most systems 
work exceedingly well. Among the most popular 
are: SPEED, the first such program, loading and 
saving at 1500 (?) baud; HISPED (Palomar 
Software, 170 S. Palomar Dr.. Redwood City, CA 
94062; $24.95), a 2000-baud system; ZIPLOAD, 
in the public domain and published in the 80 
Encyclopedia {Wayne Green, Inc.); and B-17 
(ABS Suppliers, P.O. Box 8297, Ann Arbor, MI 
48107; $25). 

Each of these save/load programs patches into 
the BASIC operating system, and all use the 
DOS-reserved LOAD and SAVE commands. 
The last is of particular interest because it is a 
complete system rather than merely a save/load 
program. 

SAVE, using a six-character name, sends 
BASIC programs to tape; LOAD? verifies them. 
LOAD puts the computer into the SYSTEM 
mode automatically and loads a BASIC program. 
PUT and GET are used for formatted file arrays. 
It is also provided with a machine language 
module. Checksum errors, full memory buffer, 
continuity errors, and format errors are reported 
by this module. The entire source code is 
available for sale if the B-17 program is also 
purchased. 

Aside from B-17's high reliability, it also 
provides an on-screen prompt indicating saving 
and loading. 

What makes a high-speed loader not only 
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703D 0607 
7032 10FE 

7034 C1 

7035 09 



7036 
7037 
7039 
703A 
703D 
703F 
7040 
7042 
7043 
7045 
7047 
7048 
704A 
7040 
7040 
704F 
7050 
7052 
7054 
7058 
7058 
705A 
7050 
7050 
705E 



705F 
7060 
7063 
7066 
7069 
706A 
706C 
706F 
7071 
7073 
7074 
7076 
7078 
707B 



C5 

E601 

47 

3A3D40 

E6FC 

80 

03FF 

C5 

0605 

10FE 

01 

CB00 

E6FC 

80 

D3FF 

C5 

0606 

10FE 

E6FC 

D3FF 

0608 

10FE 

01 

01 

09 



AF 

C01202 

010000 

CD6000 

C5 

0E00 

CD0070 

0608 

10FE 

01 

10F3 

0EA5 

CD0070 

09 



707C 0608 
707E 0DBA70 
7081 CD9070 

7084 17 

7085 CB11 
7087 10F5 
7089 09 



708A 0DC770 
7080 DBFF 
708F 17 
7090 30FB 

7092 05 

7093 060F 
7086 10FE 

7097 C 

7098 000770 
709B 09 



7090 05 
7090 0618 
709F 10FE 
70A1 DBFF 
70A3 01 
70A4 09 



70A5 AF 
70A6 001202 
70A9 CD8A70 
70AC CD9G70 
70AF 17 
70B0 30F3 



00580 

00590 

00600 

00610 

00620 

00630 

00640 

00650 

00660 

00670 

00680 

00690 

00700 

00710 

00720 

00730 

007 40 

00750 

00760 

00770 

07 80 

007 90 

00800 

00810 

00820 

00830 

00840 

00850 

00860 

00870 

00880 

00890 

00800 

00910 

00920 

00930 

00940 

00950 

00960 

00970 

00980 

00990 

01000 

01010 

01020 

01030 

01040 

01060 

01060 

01070 

01080 

01090 

01100 

01110 

01120 

01130 

01140 

01150 

01160 

01170 

011B0 

01190 

01200 

01210 

01220 

01230 

01 240 

01250 

01260 

01270 

01280 

01290 

01300 

01310 

01320 

01330 

01340 

01350 

01380 

01370 

01380 

01380 

01400 

01410 

01420 

0143 

01440 

01450 

0146 

01470 

01480 

01490 

01500 

01510 

01520 

01530 

01540 

01550 

01560 

01570 

01580 

01590 



LD 

DJNZ 
POP 
RET 



B.07H 



TIMING VALUE 6 1 .77 MHZ 
IS EQUAL TO 113 USECS 
RESTORE NUMBER OF BITS 
BACK TO BIT WRITE ROUT. 



ttttttttttttttHittttttttttttttttttttttttttt* ttlittlttl 

ROUTINE TO WRITE INDIVIDUAL BIT TO TAPE (OR NOT IF 0] 
ttttftftttttlfHHttttttttittititttttllttltltttttfttttt 

SAVE NUMBER OF BITS 
MASK OUT ALL BUT BIT 
SAVE A IN B REGISTER 
GET SCREEN STATUS 
MASK OUT LOW TWO BITS 
SET BIT OR NOT 
SEND OUT CASSETTE PORT 
SAVE B REGISTER AGAIN 
TIMING VALUE FOR BIT 
DELAY IS 65 USECS 
GET VALUE BACK INTO B 
ROTATE INTO BIT 1 
MASK OUT LOW BITS AGAIN 
SET BIT 1 OR NOT 
SEND OUT CASSETTE PORT 
SAVE B REGISTER AGAIN 
DELAY IS 83 USECS 
DELAY FOR BOTTOM OF BIT 
CREATE A NEUTRAL BIT 
AND WRITE IT TO TAPE 
GET DELAY VALUE IN B 
DELAY IS 110 USECS 
CLEAR STACK OF BIT 
GET ORIGINAL BITS BACK 
BACK TO SAVING ROUTINE 

IttltttttttttltitttttttttftttttttHttttttttttttt Willi 

ROUTINE TO WRITE LEADER OF 256 BYTES OF FF PLUS SYNC A5 
ttttHtHHt*ttttttttlttHtt*tttttltt*IHItttttttttttti 



PUSH 


BC 




AND 


1 




LD 


B.A 




LD 


A,!4030H 


AND 


OFCH 




ADD 


A.B 




OUT 


(OFFH] 


,A 


PUSH 


BC 




LD 


B.05H 




DJNZ 


S 




POP 


BC 




RLC 


B 




AND 


OFCH 




ADD 


A.B 




OUT 


(OFFHJ 


.A 


PUSH 


BC 




LD 


B.06H 




DJNZ 


S 




AND 


OFCH 




OUT 


(OFFH) 


A 


LD 


B,08H 




DJNZ 

POP 

POP 


$ 

BC 

BC 




RET 







XOR 

CALL 

LD 

CALL 

PUSH 

LD 

CALL 

LD 

DJNZ 

POP 

DJNZ 

LD 

CALL 

RET 



A 

021 2H 

BC.O 

0060H 

BC 

CO 

WRITE 

B.8 

S 

BC 

SYLOOP 

C.DA5H 

WRITE 



DEFINE DRIVE NUMBER 
DRIVE MOTOR RUNNING 
NEED A LOOP ABOUT 1 SEC 
CALL DELAY IN ROM 
SAVE THIS VALUE (BC=0) 
WRITE BYTE OF 1111 1111 
WRITE THAT BYTE 
SHORT LOOP BETW. BYTES 
DELAY JUST 58 USECS 
RESTORE VALUE FOR USE 
WRITE TOTAL OF FF BYTES 
SYNCHRONIZATION BYTE 
WRITE THAT BYTE 
BACK TO MAIN ROUTINE 



tttttttttttttttttttttttttttttttttttttitttttmttttttttt 

READ BYTE SUBROUTINE: COMPLETED BYTE INTO C REGISTER 
tt*tfttttttlttttttt*tttttttnttltttttttttt ttttitttttttt 



READ 
RLOOP 



LD 

CALL 

CALL 

RLA 

RL 

DJNZ 

RET 



REDEX 
REDBIT 



C 
RLOOP 



NUMBER OF BITS TO READ 
READ TIMING BIT 
READ DATA BIT IF ANY 
ROTATE BIT INTO CARRY 
ROTATE CARRY INTO C 
DO IT TOTAL OF B TIMES 
BACK FROM READ ROUTINE 



tttitttttittttttttttttittttttttttttttttHttittttttttnt 

ROUTINE TO READ TIMING BIT FROM TAPE AND DELAY AFTER 

HIW WWII f lift WWWtWWWIWilWIIWItt 



REDEX CALL 



REDX2 



IN 

RLA 

JR 

PUSH 

LD 

DJNZ 

POP 

CALL 

RET 



INSIG 
A, (OFFH) 

NCREDX2 

BC 

B.OFH 



BC 
INSIG 



KEEP LOOKING FOR ONE 
KEEP LOOKING FOR ONE 
ROTATE INTO CARRY 
KEEP LOOKING FOR ONE 
SAVE NUMBER OF BITS 
VALUE TO DELAY 
AND DELAY FOR 144 USECS 
RESTORE NUMBER OF BITS 
RESET INSIG FLIP-FLOP 
BACK TO MAIN ROUTINE 



It it WWW W W ti W Wl Wi t WW! WWW 

ROUTINE TO READ INDIVIDUAL DATA BIT (IF ANY) FROM TAPE 

ttit*ttttttnntttitntit*nwt*ntntttttttttttttttttt 



PUSH 

LD 

DJNZ 

IN 

POP 

RET 



BC 

B.1BH 

S 

A, (OFFHJ 

BC 



SAVE VALUE IN 8 AND C 
VALUE FOR DELAY 
EQUAL TO 197 USECS 
GET VALUE FROM CASSETTE 
RESTORE VALUES TO B B. C 
RETURN WITH VALUE IN A 



iiWItWWIWWWWWWWWWtttWt tlWIS 
THIS ROUTINE READS THROUGH THE LEADER FOR SYNC BYTE 

It WWW WW Wit Wit WWIWWWiiwmmt 



XOR 

CALL 

CALL 

CALL 

RLA 

JR 



A 

21 2H 

REDEX 

REDBIT 

NC.REDSYN 



DEFINE DRIVE NUMBER 
DRIVE IS RUNNING 
READ TIMING BIT 
GET SIT FROM TAPE 
ROTATE INTO CARRY FLAG 
KEEP LOOKING FOR A 1 



possible, but reliable, especially since the 
TRS-80's 500-baud rate seems to be full of flaws? 
As noted in the Supplement to Chapter 6 (?), the 
500-baud rate is actually fairly reliable, except 
that a few misconceptions on the part of the 
ROM designers led to incorrect load timing. The 
writers of the high speed loaders noted above 
took considerably more care in designing their 
input/output schemes, and thus achieved that 
reliability. 

Listing 9-2 presents a pair of high-speed 
input/output modules that load and save blocks 
of memory at 2000 (?) baud. These modules may 
supplant the CALLs to 0235 in all the 
input/output routines presented elsewhere in 
this book, allowing faster saving and loading of 
memory blocks, data, screens, etc. These 
routines use the normal cassette output. For a 
high-speed loader using an 8-track system and 
digital, very reliable recording, see Chapter 9. 

A Paper Tape Reader 

' One of the more common sights in the early 
days of larger computers was a bank of spinning 
tape reels for magnetic and punched tapes. Both 
still exist, but are not common storage modes for 
microcomputers like the TRS-80. 

However, you may have the chance to pick up 
some terrific programs written for an 8080-based 
computer, especially those in the National 
Semiconductor library. These include 
double-precision mathematical subroutines, text 
handlers, light-pen readers, etc., and are 
sometimes available at low prices. But they are 
stored on rolls of paper tape. Software for 
devices such as the Computalker Speech Lab is 
also provided on paper tape. 

Furthermore, though paper tape may no 
longer be the popular program storage medium it 
once was, for archival storage or communicating 
among different styles and types of computers, it 
still has its place. For occasional use, then, paper 
tape can be used, but an expensive reader won't 
be a very good investment. For less than $50, you 
can interface the TPR-1 paper tape reader and 
the TRS-80. 

The TPR-1 reader is sold by Raeco, Box 165, 
Washington, Maine 04574. The unit consists of a 
machined, brushed aluminum track for the paper 
tape, and a-eircuit board attached to the track. 
On the board are two integrated circuits, and 
nine light sensors are on the board under holes in 
the track; also provided are an LED test light, 
resistors, and a 14-pin DIP socket. It is sold with 
a good technical manual for $32.50; an optional 
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Chapter 9 



A Paper Tape Reader 



70B2 CB11 
70B4 0B07 
70BB CDBA70 
70B9 0D8C70 
70BC 17 
70BD CB11 
7QBF 10F5 
70C1 3EA5 
70C3 B9 
70C4 OB 
70C5 1BDE 



7QC7 F5 
70CB 3A3D40 
700B D3FF 
70CD F1 
7DCE C9 



700F 
70D0 
70D3 
7007 
70D8 
70DA 
70DB 
70DC 
70DD 
70DE 
70E1 
70E2 
70E3 
70E6 
70E7 
70EB 
70E9 
70EA 
70EB 
70EE 
7DEF 
70F0 
70F3 
70F6 
70FB 
70FB 
70 FC 
70FD 
7DFE 
7101 
7102 
7103 
7105 
7106 
7107 
7108 
710C 
710E 
710F 
7112 
7113 
7116 
7119 
7110 
711F 



F3 

2AB140 

EDSBA440 

05 

ED52 

E5 

01 

E1 

C5 

CDA570 

C1 

05 

CD7C70 

71 

G1 

OB 

7B 

B1 

CA9719 

7E 

A7 

020271 

3A3F3C 

EEOA 

323F3C 

2B 

7E 

A7 

CA0571 

23 

23 

1BDD 

23 

AF 

77 

ED5BA440 

3EFF 

12 

CDFG1A 

23 

22F9 40 

GD0901 

CD611B 

CDFE01 

C3CC0B 



7122 
7123 
7125 
7128 
71 2B 
712E 
7132 
7135 
7136 
7137 
713A 
713B 
713C 
713F 
7140 
7141 
7144 
7145 
71 48 
71 4A 
7140 
714E 
714F 



F3 

3E2A 

323 E30 

323F3C 

2AA440 

ED5BF940 

CD5F70 

70 

BA 

C23F71 

70 

BB 

CA5671 

7E 

A7 

C24E71 

F5 

3A3F3C 

EEOA 

323F3C 

F1 

4F 

CD0070 



01600 

01610 

01820 

01630 

01640 

01650 

01660 

01670 

016B0 

01690 

01700 

01710 

01720 

01730 

01740 

01750 

01760 

01770 

017B0 

01790 

01800 

01810 

01 820 

01B30 

01B40 

01B50 

01B60 

01870 

01BB0 

01B90 

01900 

01910 

01920 

01930 

01940 

01950 

01960 

01970 

019B0 

01990 

02000 

02010 

02020 

02030 

02040 

02050 

02080 

02070 

02080 

02090 

02100 

02110 

2120 

02130 

02140 

02150 

02160 

02170 

02180 

02190 

02200 

02210 

02220 

02230 

02240 

02250 

0226 

227 

02280 

022S0 

02300 

02310 

02320 

02330 

23 40 

02350 

02360 

02370 

02380 

23 90 

02400 

02410 

02420 

02430 

2440 

02450 

246 

2470 

02480 

02490 

02500 

02510 

02520 

253 

02540 

02550 

02560 

02570 

02580 

02590 

026 00 

02610 



RL 

LD 

CALL 

CALL 

RLA 

RL 

DJNZ 

LD 

CP 

RET 

JR 





B,7 
REDEX 
REDBIT 

C 

SYNCLP 

A.0A5H 

C 

Z 

REDSYN 



ROTATE INTO C REGISTER 
NUMBER OF BITS LEFT 
READ TIMING BIT 
GET BIT FROM TAPE 
ROTATE INTO CARRY FLAG 
ROTATE INTO C REGISTER 
00 IT 7 TIMES LEFT 
LOAD SYNC BYTE VALUE 
COMPARE AGAINST C 
RETURN IF A MATCH 
BACK TO KEEP LOOKING 



f ########### $tilttitttttHt»l*ttH***tttt «###«#«#«# 
ROUTINE TO RESET INSIG FLIP-FLOP TO BE ABLE TO READ 

#####*##S#S#######f ############*###### «############### 



PUSH AF 

LD A.1403DH) 

OUT (OFFH).A 

POP AF 

RET 



SAVE VALUE IN AF 

GET SCREEN STATUS BYTE 

RESET FLIP-FLOP 

RESTORE AF STATUS 

BACK TO READING ROUTINE 



t*tttttttttttHt»ttttttHtHtlttt*ltt*tttttt*ttl*Htttt 

THIS ROUTINE WILL LOAD A BASIC PROGRAM WITH NO FILENAME 
ItitttttttttttttttltttHttitHUfttlttttlttttftftttttft 



JUMPS 



01 

LD 

LD 

PUSH 

SBC 

PUSH 

POP 

POP 

PUSH 

CALL 

POP 

PUSH 

CALL 

LD 

POP 

DEO 

LD 

OR 

JP 

LD 

AND 

JP 

LD 

XOR 

LD 

DEC 

LD 

AND 

JP 

INC 

INC 

JR 

INC 

XOR 

LD 

LD 

LD 

LD 

CALL 

INC 

LD 

CALL 

CALL 

CALL 

JP 



HL,(40B1H) 

DE.140A4H) 

DE 

HL.DE 

HL 

BC 

HL 

BC 

REDSYN 

BC 

BC 

READ 

(HLJ ,C 

BC 

BC 

A,B 

C 

Z.1997H 

A,(HL) 

A 

NZ.JUMP3 

A,(3C3FH) 

OAH 

[3C3FH) ,A 

HL 

A,(HL) 

A 

Z.JUMP4 

HL 

HL 

TREAD 

HL 

A 

(HL) ,A 

DE, I4DA4H) 

A,OFFH 

(DE) ,A 

1AFCH 

HL 

(40F9H1 

01C9H 

1B61H 

01FEH 

06CCH 



HL 



GET RID OF BOTHERS 
GET TOP OF BASIC MEMORY 
GET BASIC PROGRAM PTR. 
SAVE IT A MOMENT 
GET MEMORY AVAILABLE 
GET READY FOR TRANSFER 
COUNT OF MEMORY IS IN B 
BEGINNING OF BASIC = HL 
SAVE AVAILABLE MEMORY 
CALL READ SYNC ROUTINE 
RESTORE AVAILABLE MEM. 
SAVE BYTE COUNT 
READ ONE BYTE 
GET VALUE TO VIDEO MEM 
GET BYTE COUNT BACK 
REDUCE COUNT BY ONE 
GET HIGH BYTE OF MEMORY 
AND CHECK AGAINST LOW 
OM ERROR IF TOO MUCH 
GET VALUE IN HL 
TEST IF A ZERO 
PAST FLASH IF OKAY 
GET PLACE ON SCREEN 
AND TOGGLE STAR & SPACE 
AND PUT BACK ON SCREEN 
GO BACK SPACE FOR TEST 
GET VALUE THERE 
TEST IF A ZERO ALSO 
GO TO END ROUTINE IF 
BACK TO PROPER BYTE 
READY NEXT MEM LOC'N 
AND THEN GO BACK 
GET NEXT MEMORY LOC'N 
LET A BE EQUAL TO ZERO 
AND PUT IT IN PLACE 
GET START OF PRGRM PTR 
GET RESETTING CODE 
PUT AT PROGRAM START 
RESET ALL LINE NUMBERS 
HL MOVED PAST PROGRAM 
SIMPLE VARIABLE POINTER 
CLEAR THE SCREEN NOW 
CLEAR ALL THE POINTERS 
TURN CASSETTE OFF 
GO TO BASIC "READY" 



ttttttltHtffttHtttttttttttt*ttttlt*ltl»Hlttt»tUtttt* 

THIS ROUTINE IS A GERMINAL ROUTINE TO CSAVE A PROGRAM 
WITHOUT A PROGRAM NAME. FORMAT: /PUT. THE 500-BAUD 
BLOCK SAVE CAN BE USED AS AN EXAMPLE OF HOW TO EMPLOY 
A PROGRAM NAME IN SAVING A PROGRAM. 
ttttttttttt*HHttHtttttti*tttttttHttHtttttttHttttl 



DI 

LD 

LD 

LD 

LD 

LD 

CALL 

LD 

CP 

JP 

LD 

CP 

JP 

LD 

AND 

JP 

PUSH 

LD 

XOR 

LD 

POP 

LD 

CALL 



A.2AH 

(3C3EH) ,A 

(3C3FH) .A 

HL,(40A4HJ 

DE, [40F9HJ 

SYNCHR 

A,H 

D 

NZ,JUMP01 

A.L 

E 

Z.GOOUT 

A.(HL) 

A 

NZ.JUMP02 

AF 

A.13C3FH) 

OAH 

(3C3FH) ,A 

AF 

O.A 

WRITE 



GET RID OF BOTHER 
GET READY AN ASTERISK 
PLACE STAR ON SCREEN 
PLACE STAR NEXT TO IT 
START OF BASIC PROGRAM 
BOTTOM OF VAR. POINTER 
WRITE LEADER AND SYNC 
GET CURRENT HIGH MSB 
SAME AS TARGET MSB? 
CONTINUE IF NOT SAME 
SAME HI MSB - READY LOW 
SAME AS TARGET LSB? 
DONE WITH SAVE IF SO 
ELSE GET VALUE IN MEM 
TEST IF A ZERO 
JUST GO ON IF NOT 
SAVE VALUE IN A 
GET TOGGLE VALUE TO A 
TOGGLE STAR a SPACE 
AND PUT IT ON SCREEN 
GET VALUE BACK TO A 
PUT BYTE IN REGISTER 
; WRITE BYTE TO TAPE 



case is $5.00. Photo 1 shows the unit mounted 
inside the smallest Radio Shack equipment box. 
Eight-level (eight bit) paper tape is capable of 
storing parallel bytes of data by means of holes 
punched in the tape. A smaller, ninth hole - 
placed between the third and fourth holes - 
provides a timing signal for the reading program. 

The ninth hole also can be used as a data-ready 
signal. By the time the light just triggers the 
circuitry as it passes along the edge of the smaller 
hole, the larger holes are letting in plenty of light 
for the data to be stable, ready to read. 

The TPR-1 comes ready to hook to a computer 
bus. Its output is in parallel, and all signals are 
tri-state. Because it uses only 12 mA, it's possible 
to run the reader directly from the TRS power 
supply. 

Figure 9-4 presents the diagram of the 
TPR-1. The low-power CMOS integrated 
circuits Ul and U2 evaluate the state of the data 
as seen by the light-sensitive transistors and 
provide a parallel output. Part of U2 is also used 
to drive the LED, which blinks on whenever data 
is stable at the output of the reader. 

Figure 9-5, is the TRS-80 interface schematic. 
Zl and Z2 decode the port address 3F in order to 
activate tri-state buffer Z3. This separate port 
decoding is necessary because the TPR-1 was not 
designed with the READY line separately 
activated from the data lines. Were that the case, 
READY might be tested at all times. That way, 
data would only be input whenever READy 
indicated stable data. In its present 
configuration, however, a separate buffer must 
be used for the TPR-1 data lines. 

Z4 is a flip-flop which produces an interrupt 
signal and sends it to the TRS-80 INT line; 
INTAK (interrupt acknowledge) is used to clear 
the interface flip-flop when data has been read. 
This configuration is similar to that used for the 
interrupt based real time clock (see Chapter 8 ). 

The circuit can be wire-wrapped on a small 
piece of perfboard and mounted inside a case 
with the TPR-1. A detachable 40-pin cable can 
also be used to save a few dollars. 

Listing 9-2 presents the software to read one 
page (256 bytes) of data into the TRS-80 and 
store it in memory. Recall that the interrupt 
patch point at 4012 is initialized with C9, a 
RETurn instruction. In its place, then, a patch 
must be made to one of three interrupt service 
routines which will read each byte of data as it 
becomes stable at the output of the TPR-1. Since 
the reader will not likely be a device used very 
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A Paper Tape Reader 



7152 23 

7153 C33571 
7156 ODFE01 
7159 C9 



BITEX 

GOOUT 

INSI6 

JUHP01 

JUMP02 

JUMP3 

JUHP4 

LOODOP 

HEAD 

REDBIT 

HEDEX 

REDSYN 

REDX2 

RLOOP 

bYLQOP 

SYNCHR 

SYNCLP 

TEMPER 

TEHPEX 

TIMEX 

TREAD 

WLOOP 

WRITE 



7036 
7156 
7DC7 
71 3F 
71 4E 
7102 
7105 
7135 
707C 
709C 
708A 
70A5 
70BD 
707 E 
7DB9 
70 5F 
70B6 
70CF 
7122 
7014 
70 E2 
700B 
7000 



02620 
02630 
26 40 
02650 
02660 
02670 
26 BO 
02690 
02700 
02710 
02720 
00670 
02640 
01760 
02520 
02600 
02160 
021 BO 
0246D 
01160 
01430 
012B0 
01540 
01290 
01170 
01010 
00970 
01620 
U1860 
02390 
00440 
01970 
00330 
002BO 



INC HL 

JP LOOOOP 

GOOUT CALL 01FEH 
RET 

ttltiitHtlttHtlttttittil 

REMEMBER: ENTRY POINT FOR 
REMEMBER: ENTRY POINT FOR 
lit ttttlttttltlHtttittti*' 

END 
00360 
02510 

Q12BD 013B0 
02460 
02540 
02070 
02140 
02630 
01980 

01180 01570 01630 
01170 01560 01620 
01590 01700 01950 
01310 
01210 
01070 
02450 
01660 



00330 
02170 
00370 
01030 01090 02610 



; GET NEXT MEMORY LOC'N 

i LOOP AROUND FOREVER 

: TURN OFF CASSETTE 

i BACK TO MAIN ROUTINE 

ifttlttttttttltttttf ######### 
SAVE ROUTINE IS TEMPEX 
LOAD ROUTINE IS TEMPER 

'■ttttttttltttittttttttttttttt 



NOTES - 

i. OUTPUT DATA IS TRUE; 
I.E. A "ONE" (HOLE) ON THE 
TAPE GIVES A HIGH !5VI 
VOLTAGE LEVEL OUTPUT. 

2. MAXIMUM LOADING ON ANY 
OUTPUT IS TWO STANDARD 
TTL LOADS. 

3. Ql THRUQ9-MRDI50 
OPTICALLY MATCHED, DO NOT 
SUBSTITUTE. 



UI.U2<4502 



often, this kind of interrupt-hogging is not a 
problem. If you have a Teletype with a built-in 
paper punch, though, you might want to 
configure this interrupt software so it can be 
patched in only when it's needed. 
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Figure 9-4. TPR-1 schematic diagram. 
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Photo 9-6. Paper tape reader. 

TPR-1 tape reader has machined aluminum track and data 

indicator LED. 
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READY 
READ? 
GHD 
ENABLE 



Figure 9-5. TPR-1 interfacing schematic. 
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Only four integrated circuits form the complete tape reader 
interface. Power supplies both reader and interface. 



The program is entered at line 1160. The 
screen is cleared, and the user is prompted to 
enter a base address in hex. This is the address 
starting at which the tape data is to be loaded 
into memory. The keyboard is scanned for 
characters to 9 and A to F; these are displayed, 
and when ENTER is pressed, the characters are 
converted to a starting address. 

The tape must be threaded before actual data 
reading is begun, because during threading it's 
possible to present false information to the 
TRS-80. The tape reading is begun at line 1740. 
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An 8-Track Mass Storage System 



Listing 9-3. Paper tape reader program. 



4013 
06CC 
3C00 



4012 
4012 C3 
7D00 



7000 21003C 
7D03 11013C 
7DDB 01FF03 
7009 3620 
7D0B EDBO 
7D0D C9 



7D0E 3A4038 
7011 FE02 
7013 20F9 
7D15 C9 



7016 7E 

7017 A7 

7018 C8 

7019 12 
7D1A 23 
7D1B 13 
7D1C 18F8 



7D1E FS 
7D1F E6F0 
7D21 1F 
7022 1F 
7D23 1F 

7024 1F 

7025 FEOA 
7027 3004 
7D29 C630 
7D2B 1B02 
7D2D C637 
7D2F 77 

7030 23 

7031 F1 

7032 EBOF 
7034 FEOA 
7036 3004 
7D3B C630 
7D3A 1802 
7D3C C637 
7D3E 77 
7D3F 09 



7D40 F3 

7041 AF 

7042 C9 



7D43 F3 
7044 DB3F 
7046 0D1E7D 
7049 AF 
7D4A C9 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
001BO 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
00320 
00330 
00340 
00350 
00360 
00370 
00380 
003 90 
00400 
00410 
00420 
0043 
00440 
00450 
00460 
00 470 
00480 
00490 
00500 
00510 
00520 
0053 
00540 
00550 
00560 
00570 
00580 
00590 
00600 
00610 
00620 
00630 
00640 
00650 
00660 
00B70 
00680 
00690 
00700 
00710 
00720 
00730 
00740 
00750 
00760 
00770 
07 80 
07 80 
00800 
00610 
00B20 
00B30 
008 40 
00850 
00860 
00870 

008 80 
00890 
00900 
00910 
00920 
00930 
00940 
00950 
00960 
00970 

009 80 
009 90 
01000 
01010 
01020 
01030 
01040 
01050 
01060 
01070 
01080 



tUftlHttHHIiltttHtittttlttttttltttttttitiilttHItt 

TAPE READER AND 256-BYTE LOADER ROUTINE 
DENNIS BATHORY KITSZ, ROXBURY, VERMONT 05669 

t*t*tttttttttttltttti»tttlt*Htltitttft*tHtttttttttltt 



VECTOR 

BASIC 

VIDEO 



EQU 401 3H 

EQU 06CCH 

EQU 3C00H 



INTERRUPT VECTOR PATCH 
;RETURN TO BASIC READY 
;BE6INNING OF SCREEN 



ItttttttHlltittttttttttttttHttttttttttttittttttlttttt 

INTERRUPT VECTOR'AT 401 2H 



ORG 401 2H 

DEFB 0C3H 

ORG 07D00H 



; CURRENT VALUE IS C9 
: REPLACE WITH JUMP 
ROUTINES BEGIN HERE 



tttttttittttHtttttitttttttttittttttttitttttttttttttttt 

CLEAR SCREEN SUBROUTINE 

*t*tttttttt*titnt*tttttt*nttttittttttittt*t**ttti*tn 



CLEAR LD 
LD 
LD 
LD 

LDIR 
RET 



HL.VIDEO 
DE.VIDEO+1 
BC.03FFH 
CHL) .20H 



GET START OF VIDEO 
GET DESTINATION POINT 
GET MEMORY BLOCK SIZE 
WRITE SPACE INTO VIDEO 
BLOCK MOVE CLEAR SCREEN 
BACK FROM SUBROUTINE 

sua 



; t*itttttttttttitttttt§ttttttt»t*tttnttttttttttttt 

; SCAN FOR ENTER SUBROUTINE 

i tttttttttttlfttiliHttttttttttttfttttltltttttttttHttti 



LD 


A,(3840H) 


CP 


2 


JR 


NZ, ENTER 


RET 





ENTER LD A,(3840H) ; "ENTER" KEYBOARD ROW 

"ENTER" KEYBOARD COLUMN 
LOOP UNTIL KEY PRESSED 
BACK FROM SUBROUTINE 

################### ###«#############«######«######## 
DISPLAY MESSAGE SUBROUTINE 
tttt*ttttttt*t*tttttttttlt*ttt*tttt*ttttttttttttttttttt 



LD 

AND 

RET 

LD 

INC 

INC 

JR 



A,(HLJ 

A 

Z 

IDE) ,A 

HL 

DE 

DISPLY 



;GET BEGINNING OF TEXT 
;CHECK IF A NULL 
;EXIT SUBROUTINE IF NULL 
i DISPLAY CHARACTER IN A 
iGET NEXT MESSAGE LOC'N 
;GET NEXT SCREEN LOC'N 
;LOOP FOR CHARACTER TEST 



CONVERT TO ASCII SUBROUTINE 

tt*tnttttttttt tHttttttittitttnttttttttttttttt ####### 



HIBYTE 
NEXT 



HIBTE2 
NEXT2 



PUSH 

AND 

RRA 

RRA 

RRA 

RRA 

CP 

JR 

ADD 

JR 

ADD 

LD 

INC 

POP 

AND 

CP 

JR 

ADD 

JR 

ADD 

LD 

RET 



AF 
OFOH 



OAH 

NC. HIBYTE 

A.30H 

NEXT 

A.37H 

(HL1 ,A 

HL 

AF 

OFH 

OAH 

NCHIBTE2 

A.30H 

NEXT2 

A.37H 

(HL) ,A 



SAVE ACCUM. AND FLAGS 
MASK OUT LOW 4 BITS 
MOVE NIBBLE TO RIGHT... 

...SOME MORE 

...SOME MORE 

...UNTIL DONE 
IS IT TEN OR GREATER? 
MOVE ALONG IF > TEN 
ASCII = NUMBER PLUS 30H 
GO ON TO LOW NIBBLE 
ASCII = NUMBER PLUS 37H 
DISPLAY FIRST ASCII CHAR 
GET NEXT SCREEN LOC'N 
RESTORE ORIGINAL HEX 
MASK OUT HIGH 4 BITS 
IS IT TEN OR GREATER? 
MOVE ALONG IF > TEN 
ASCII = NUMBER PLUS 30H 
GO TO DISPLAY S OUT 
ASCII = NUMBER PLUS 37H 
DISPLAY NEXT ASCII VALUE 
BACK FROM SUBROUTINE 



ttttttHltlltHtltDlttttlttltttHtttitttttitittttt 
CLEAR TAPE READER INTERRUPT ACKNOWLEDGE 
tttttttttltiittltfitiitttttlitttlltttlHtittlttttl 



Slit 



DI 

XOR 

RET 



INTERRUPT OFF IN SERVICE 
;CLEAR ACCUM. & FLAGS 
;BACK FROM SUBROUTINE 



HtttttttttttltittltttitlttttttltttttftttlttttttttttHH 

PAGE ADDRESS INTERRUPT SERVICE 
tttttttttttttttttttHtttttttttttttttittltttttttttlttttt 



DI 

IN A.C3FHJ 

CALL CONVRT 

XOR A 

RET 



INTERRUPT OFF IN SERVICE 
GET VALUE FROM READER 
CONVERT VALUE TO ASCII 
CLEAR ACCUM. & FLAGS 
BACK FROM SUBROUTINE 



ttttttttttttH»ttHtttttHtttttHttttHtttHttttHtt*lt 

READ DATA / PLACE ON SCREEN INTERRUPT 

ttttttttttttttmttimtttttittttttiittttittttttftttttt 



SERVE2 DI 



i INTERRUPT OFF IN SERVICE 

Listing Continued . , , 



With the software shown, the tape to be read 
must be in the following format: 

1-byte code of information (tape number, 
address page, etc.), which is displayed but 
not to be stored in memory. 

256 bytes of data. 

1-byte simple checksum. 

If the tape is not in this format, the program 
can be easily altered to accommodate any other 
256-byte data block format. 

Interrupts are then enabled (lines 1810-1820), 
and a series of short interrupt service routines are 
activated. The first routine merely waits for the 
interrupt line to clear, as it may have been set by 
stray light in the room when the tape is threaded 
(lines 1820-1870). 256 bytes are then loaded and 
displayed (lines 1910-2030). The checksum is 
calculated and displayed (lines 2050-2130), and 
the checksum is read from tape and displayed 
(lines 2150-2280). If there is a match, the 
memory pointer is advanced in order to read the 
next block of tape; otherwise, it is reset to the 
beginning of the block, allowing the tape to be 
read again, (lines 2210-2420). Finally, the option 
of loading additional blocks or returning to 
BASIC is presented (lines 2440-2540). 

Using the TPR-1, the interface, and this 
simple software, the wealth of 8080 programs, as 
well as programs saved in an archival paper tape 
format, may be read into your TRS-80 and used. 

An 8-Track Mass Storage System 

Oh, no! Here comes another one! I'd like to 
join the mass storage fray with another device 
capable of loading and saving programs at high 
speed. It's not as slow as a cassette, not as fast as 
a Stringy-Floppy, but it has one interesting 
capability: sequential-random access. That's a 
mythical term for sequential access of more than 
one track at a time. 

Here's how it works: 8-track cartridges play 
one-quarter their total length on each pass. Then 
the head switches from the first stereo pair to the 
second, the second to the third, the third to the 
fourth, and from the fourth back up to the first. 
A so-called '40-minute' cartridge is actually 10 
minutes long, four passes. The shortest 
commercially available cartridges are 20 minutes 
long, five minutes per pass. 



The Custom TRS-80 
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Continued Listing 










7D4C 


DB3F 


01090 




IN 


A, !3FHJ 


GET VALUE FROM READER 


7D4E 


77 


01100 




LD 


(HL) ,A 


PUT IT INTO MEMORY 


7D4F 


B1 


01110 




ADD 


A.C 


GET VALUE FROM CHECKSUM 


7D50 


4F 


01120 




LD 


C,A 


RESTORE UPDATED CHECKSUM 


7D51 


23 


01130 




INC 


HL 


GET NEXT MEMORY LOC ' N 


7052 


AF 


01140 




XOR 


A 


CLEAR ACCUM. & FLAGS 


7D53 


C9 


01150 
01160 




RET 




BACK FROM SUBROUTINE 






01170 


; ************* 


****************************************** 






01180 


; CHECKSUM INTERRUPT ROUTINE 








01190 


: ##### 


******** 


********************* ********************* 






01200 










7D54 


F3 


01210 


SERVES 


DI 




INTERRUPT OFF IN SERVICE 


7D55 


DB3F 


01220 




IN 


A,(3FH) 


GET VALUE FROM READER 


7D57 


47 


0123 




LD 


B,A 


SAVE IT IN B REGISTER 


7DS8 


AF 


01240 




XOR 


A 


CLEAR ACCUM. & FLAGS 


7D59 


C8 


01250 
0126 




RET 




BACK FROM SUBROUTINE 






01 27 


; HHHttttttt 


ft**************************************** 






012B0 


; MESSAGES FOLLOW 








01290 


; ************* 


****************************************** 






01300 


; 








7D5A 


54 


01310 


HSGN01 


DEFM 


'THREAD TAPE AND 


PRESS CLEAR. 1 


7D76 


OB 


01320 




DEFB 


00 




7D77 


4C 


01330 


HSGN02 


DEFM 


'LOADING PAGE ADDRESS: ' 


7D8E 


00 


01340 




OEFB 


00 




7DBF 


42 


01350 


HSGN03 


DEFM 


'BYTES LOADING AE 


FOLLOWS: ' 


7DAB 


00 


01360 




DEFB 


00 




7DA9 


43 


01370 


HSGN04 


DEFM 


'CALCULATED CHECKSUM IS: ' 


7DC2 


00 


01380 




DEFB 


00 




7DC3 


43 


01390 


HSGN05 


DEFM 


'CHECKSUM AS REAC 


IS: ' 


7DD9 


00 


01400 




DEFB 


00 




7DDA 


43 


01410 


MS6N06 


DEFM 


'CHECKSUM ERROR IN THIS BLOCK.' 


7DF7 


00 


01420 




DEFB 


00 




7DF8 


42 


0143 


MSGN07 


DEFM 


'BLOCK LOADED CORRECTLY.' 


7E0F 


00 


01440 




DEFB 


00 




7E10 


41 


01450 


MSGNOB 


DEFM 


'ANOTHER BLOCK? 


REPLY 1 FOR YES, 2 FDR NO 


7E39 


00 


01460 




DEFB 


00 




7E3A 


50 


01470 


MSGN09 


DEFM 


'PRESS CLEAR TO RETURN TO BASIC 


7E59 


00 


01480 
01490 




DEFB 


00 








01500 


i ***** 




****************************************** 






01510 


: REMEMBER THIS 


IS ENTRY POINT AND NOT I 






01520 


i BEGINNING OF 










0153 


; CLEAR 


SCREEN, 


DISPLAY "THREAD" 


MESSAGE 






01540 


; ***** 


******** 


St****************************************' 






01550 










7E5A 


CD007D 


0156 


START 


CALL 


CLEAR 


OUT TO CLEAR SUBROUTINE 


7E5D 


215A7D 


01570 




LD 


HL.MSGN01 


GET MESSAGE #1 LOCATION 


7E60 


11003C 


015B0 




LD 


DE, VIDEO 


GET DISPLAY LOCATION 


7E63 


GD167D 


01590 




CALL 


DISPLY 


OUT TO DISPLAY SUBROUT. 


7E66 


GD0E7D 


01600 
01610 




CALL 


ENTER 


WAIT FOR ENTER SUBROUT. 






01620 


• t****St*il***t*H*t***t*******i 


************************ 






01630 


; DISPLAY "ADDRESS" MESSAGE a F^ 


D IT 






01640 


5 S***«*t*t*t****t***ti****t**tti 


************************ 






01650 










7E69 


21777D 


01660 




LD 


HL.MSGN02 


GET MESSAGE #2 LOCATION 


7E6C 


114030 


01670 




LD 


DE.VIDE0+40H 


GET DISPLAY LOCATION 


7E6F 


CD1S7D 


01B80 




CALL 


DISPLY 


OUT TO DISPLAY SUBROUT. 


7E72 


21407D 


01690 




LD 


HL, SERVED 


GET INT #1 SERVICE ROUT. 


7E75 


221340 


01700 




LD 


(VECTOR) ,HL 


INSTALL AT INT. VECTOR 


7E78 


37 


01710 




SCF 




CARRY FLAG IS IMPORTANT 


7E79 


ED56 


01720 




IM 


1 


SET INTERRUPT MODE 


7E7B 


FB 


01730 




EI 




INTERRUPTS ON a WAITING 


7E7C 


38FE 


01740 




JR 


C.S 


SUBROUTINE CLEARS CARRYI 


7E7E 


21437D 


01750 




LD 


HL.SERVE1 


GET INT #2 SERVICE ROUT. 


7E81 


221340 


01760 




LD 


(VECTOR) ,HL 


INSTALL AT INT. VECTOR 


7E84 


215730 


01770 




LD 


HL.VIDE0+57H 


GET DISPLAY LOCATION 


7E87 


37 


01780 




SCF 




CARRY DETERMINES LOOP 


7EBB 


FB 


01790 




EI 




INTERRUPTS ON S, WAITING 


7EB9 


3BFE 


01800 
01810 




JR 


C.S 


SUBROUTINE CLEARS CARRYI 






01B20 


■ ** *** 


************************* 


tt**ttHtt*S*S*t*t*****ft 






01830 


• DISPLAY "BYTES" MESSAGE S LOAD 


256 






01840 


; ****************************** 


I************************ 






01B50 


; 








7EBB 


218F7D 


01860 




LD 


HL.MSGN03 


GET MESSAGE #3 LOCATION 


7E8E 


11B03C 


01870 




LD 


0E.VIDE0+80H 


GET DISPLAY LOCATION 


7E91 


GD167D 


01880 




GALL 


DISPLY 


OUT TO DISPLAY SUBROUT. 


7E84 


214B7D 


01890 




LD 


HL.SERVE2 


GET INT #3 SERVICE ROUT. 


7E97 


221340 


01900 




LD 


(VECTOR) .HL 


INSTALL AT INT. VECTOR 


7E9A 


210030 


01910 




LD 


HL.VIDE0+100H 


GET FIRST DISPLAY LOC'N 


7E9D 


AF 


01920 




XOR 


A 


CLEAR ACCUM. a FLAGS 


7E9E 


4F 


01930 




LD 


C.A 


CLEAR CHECKSUM REGISTER 


7E9F 


0B00 


01940 




LD 


B.OOH 


LOAD B REGISTER WITH 256 


7EA1 


37 


01950 


L00P2 


SCF 




INSTALL "JR C" LOOP 


7EA2 


FB 


01960 




EI 




INTERRUPS ON & WAITING 


7EA3 


38FE 


01970 




JR 


C.S 


SUBROUTINE CLEARS CARRYI 


7EAS 


10FA 


019B0 
01990 




DJNZ 


L00P2 


WRITE ONE PAGE TD MEMORY 






02000 


; ****************************** 


}************************ 






02010 


: DISPLAY "CHECKSUM CALC" MESSAG 








02020 


; ***** 


************************* 


if *********************** 






02030 










7EA7 


21 547 D 


02040 




LD 


HL.SERVE3 


GET INT #4 SERVICE ROUT. 


7EAA 


221340 


02050 




LD 


(VECTOR) ,HL 


INSTALL AT INT. VECTOR 


7EAD 


21A97D 


02060 




LD 


HL.MSGN04 


GET MESSAGE #4 LOCATION 


7EB0 


11403E 


02070 




LD 


DE.VIDE0+240H 


GET DISPLAY LOCATION 


7EB3 


CD167D 


020B0 




CALL 


DISPLY 


OUT TO DISPLAY SUBROUT. 


7EB6 


79 


02090 




LD 


A,C 


GET CHECKSUM CALCULATION 


7EB7 


05 


02100 




PUSH 


DE 


SAVE DISPLAY INFORMATION 

Listing Continued , . 
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For this system, the shortest 8-track cartridges 
are used in an 8-track deck with an electrical 
fast-forward mode. There are several loading 
options: 

1. Load the next program on the tape from 
the current track. The machine 
fast-forwards to the next leader and loads 
the program. 

2. Load the next program on the tape, with 
the track specified. The machine moves to 
the specified track, fast-forwards to the next 
leader, and loads the program. 

3. Load the program specified from the 
track specified. The machine moves to the 
appropriate track and reads leaders (in 
fast-forward mode) until the program is 
found, and then loads it. 

4. Load the program specified; the machine 
moves ahead and reads the directory 
immediately following the splice. The 
program is located and read. 

In this way, where the locations of programs 
are known, they may be loaded immediately. 
Otherwise, the device is somewhat directory 
organized. I add this reservation because the 
tape is sequential and programs can't be killed 
easily unless the tape is re-organized. More on 
that later. 

The advantage of this system is obvious: it 
provides somewhat faster access and loading 
than cassettes, and allows fairly fast search and 
storage. In the fast-forward mode, 20-minute 
8-track tapes can be run through completely in 
less than two minutes. Worst-case program 
access is then two minutes - when you have just 
passed the program you want to load. 
Furthermore, eight individual programs can be 
stored parallel to each other on the cartridge's 
tracks. 

As noted, to build this device, an electrical 
fast-forward is necessary. Check the manuals for 
a two-speed motor; the Craig model H240 
playback-only deck is the kind I used. Some 
modifications are necessary to the tape recorder 
itself, and alignment is a bit more critical. 



Box / Eviscerating a Cartridge 



Continued Listing 



7EBB E1 
7EB8 CD1E7D 



7EBG 21C37D 
7EBF 11B03E 
7EC2 CD167D 
7EC5 FB 
7ECB 37 
7EC7 3BFE 



7EDS 78 
7ECA D5 
7ECB E1 
7EC0 CD1E7D 
7ECF 78 
7ED0 B9 
7ED1 aBQB 



7ED3 21DA7D 

7ED6 11C03E 

7ED9 CD167D 

7EDC 1809 



7EDE 21F87D 
7EE1 11C03E 
7EE4 CD167D 
7EE7 21107E 
7EEA 11003F 
7EED CD167D 



7EF0 
7EF3 
7EF5 
7EF8 
7EFA 
7EFC 
7EFE 
7F01 
7FD4 
7F07 
7F0A 



3A103B 

FE02 

GA5A7E 

FEQ4 

2802 

18F2 

213A7E 

11403F 

CD167D 

CD0E7D 

C3CC06 



7ESA 

00000 TOTAL 



02110 
08120 
02130 
02140 
02150 
021B0 
02170 
02180 
02190 
02200 
02210 
02220 
223 
02240 
02250 
02260 
02270 
02280 
02290 
23 00 
02310 
023 20 
233 
02340 
02350 
02360 
02370 
02380 
2390 
02400 
02410 
02420 
02430 
2440 
02450 
02460 
02470 
2480 
02490 
02500 
02510 
02520 
253 
02540 
02550 
02560 
02570 
02580 
02590 
02600 
02610 
02620 
02B30 
26 40 
02650 
02660 
26 70 
26 80 
26 90 
02700 
02710 
02720 
02730 
27 40 
ERRORS 



POP HL 

CALL OONVRT 



;TRANSFER IT TO HL PAIR 
jCNVRT. CHECKSUM TO ASCII 



LD 


HL.MSGN05 


LD 


DE,VIDE0+280H 


GALL 


DISPLY 


EI 




SGF 




JR 


c,s 



tttlttftittilttHttlMlltllttitHttitttttlttttttHtttt 

DISPLAY "CHECKSUM READ" MESSAGE £ DO IT 
tttttlt**ttttlttHtttltltHHIIttHttttHt*ttttttltltH 

;GET MESSAGE #5 LOCATION 
;GET DISPLAY LOCATION 
;OUT TO DISPLAY SUBROUT. 
INTERRUPTS ON & WAITING 
; CARRY FLAG LOOP SET 
iSUBROUTINE CLEARS CARRYI 

ttHttttttHHtHttt*ltttHitttttttttHttHtttttltttttt 

DISPLAY CHECKSUM AND CHECK IT 
tHtltttttttlt*tttttitliHtttiliimttttttttttHtttttH 

iGET READ CHECKSUM BACK 
;STASH DE REGISTER PAIR 
; TRANSFER TO HL PAIR 
;CNVRT. CHECKSUM TO ASCII 
;GET VALUE AGAIN FROM B 
;CHECK WITH CALC CHECKSUM 
;CHECKSUM OKAY IF A MATCH 

ttftHitttttHHttlttltttttttttittUtttttttttttHttttti 

DISPLAY CHECKSUM BAD MESSAGE 
ttttttttttttitttttttltttltHHtttttttttittttttttttttttt 



;GET MESSAGE #6 LOCATION 
;GET DISPLAY LOCATION 
iOUT TO DISPLAY SUBROUT. 
iLOAD COMPLETE - GO OUT 



t**IHtt*ttitltttiltttftttiHtt*HttlftlttHttt*H* 

DISPLAY CHECKSUM OKAY MESSAGE 
tuttttttittlttttttttlttltlttltitttlttttttttttttttt 



LD 


A,B 


PUSH 


DE 


POP 


HL 


CALL 


CONVRT 


LD 


A.B 


CP 


C 


JR 


Z.CKSMOK 



LD 


HL.MSGN06 


LD 


DE.VIDE0+2C0H 


CALL 


DISPLY 


JR 


LEAVE 



!### 



LD 

LD 

CALL 

LD 

LD 

CALL 



HL.MSGNQ7 

DE.VIDEO+2C0H 

DISPLY 

HL.MSGNOB 

DE.VIDE0+300H 

DISPLY 



{GET MESSAGE #7 LOCATION 

[GET DISPLAY LOCATION 

:OUT TO DISPLAY SUBROUT. 

;GET MESSAGE #8 LOCATION 

;GET DISPLAY LOCATION 

;OUT TO DISPLAY SUBROUT. 



SCAN KEYBOARD FOR 1 OR & DO IT 
*tt*tftltitHttttttttlttlii)ttHttttllttttHtttiHttttt 



LOOKNG 



LD 

CP 

JP 

CP 

JR 

JR 

LD 

LD 

CALL 

CALL 

JP 



(3B10H1 



A, 

2 

Z, START 

4 

Z.DONE 

FINDYN 

HL.MSGN09 

0E.VIDE0+340H 

DISPLY 

ENTER 

BASIC 



GET 0-7 KEYBOARD ROW 
IS IT NUMBER ONE? 
BACK TO START IF SO 
IS IT NUMBER TWO? 
FINISHED ROUTINE IF SO 
KEEP LOOKING IF NEITHER 
GET MESSAGE #9 LOCATION 
GET DISPLAY LOCATION 
OUT TO DISPLAY SUBROUT. 
LOOK FOR ENTER SUBROUT. 

iBACK TO BASIC READY 



IttlttttttttHtitllttitttitittttttttHHttttlttfttttttfl 

END START [SYSTEM ENTRY POINT 



Eviscerating an 8-Track Cartridge 

Chances are that obtaining high quality 
8-track cartridges in short lengths won't be 
easy. It's not hard to make your own in roughly 
eight minute lengths - two minutes per track, 
with less than 60 seconds total access time. 
This will be enough for programs nearly 30,000 
bytes in length. 

Purchase a few cheap 8-tracks to experiment 
with. All you will need is a piece of wood, a 
pair of scissors, and a package of silver foil 
sensing tape. This is available at Radio Shack 
(catalog number 44-1155, under $2). 

Most 8-tracks are fastened together with 
plastic tabs recessed in holes on top or bottom 
of the case. There are usually five: one on each 
back corner, one under the label in the center, 
one through the capstan, and one to secure the 
remaining corner. First, insert the cartridge 
into a player and run it ahead to its splice. 

Make sure you are holding the cartridge with 
the label down. Slip a thin piece of hobby 
'half-round' - a round stick split lengthwise 
down the center - into each hole and push the 
tab back, splitting the plastic case gently with 
your hand. The dull end of a small crocheting 
hook also works well. When all the tabs are 
released, split the cartridge apart to about 
one-quarter inch. Now turn it over. Gradually 
lift the cartridge apart, being careful to note 
the tape path and exactly how much slack is 
present in the loop. 

Snip the splice out first clipping out a length 
of tape that runs to within an inch of the center 
hub. Take the loose end of the tape that winds 
around the outside of the tape 'pancake', and 
begin to pull it out. Let the hub spin freely as 
you do this, so that the tension on the wound 
tape does not change. Measure the tape 
removed (to produce the 37.5 feet for an 
8-minute cartridge) using this table: 



Total 


Total 


Remove 


to Creete 


Cartridge Time 


Fast 


8-minute Cartridge 


20 minutes 


94 




56 


22 minutes 


103 




65 


30 minutes 


141 




103 


40 minutes 


188 




150 


44 minutes 


206 




169 


45 minutes 


211 




173 


60 minutes 


281 




244 



Note: Do not use cartridges over 60 minutes long. 

Sound time consuming? It can be if you 
measure a foot at a time. Instead, anchor the 
cartridge on a table, and pull the end of the 
tape across the room (or down the hall). If 
you've purchased a 40-minute cartridge, that's 
only ten trips. 
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Box / Eviscerating a Cartridge 



Eviscerating an 8-Track Cartridge (5 photos). 
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Cartridge is flipped right side up and top of case is removed 
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Tape is removed from its path and cut at splice. 



When you've removed all the tape you need 
to, leave the same amount of slack as before 
and splice the two ends together. The oxide 
(playing) side of the tape is spliced with metal 
foil sensing tape. Make sure you splice the 
same sides to each other! Now reroute the tape 
along the original path, holding it gently in 
place; use thin cloth gloves if your hands tend 

to perspire. 



Blunt tool is inserted in slots at bottom of the cartridge as the 
sides are separated and held steady. 
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Excess tape is pulled gently from outside of the hub, letting hub 
and platter rotate freely. Note that end near center of hub has 
been cut fairly short to eliminate the possibility of tangling with 
the tape being removed. 




When enough tape has been removed ends are spliced together 
with silver sensing foil. The tape is then re-routed and the case 
snapped back together. 
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Without bending the tape or getting it 
caught, slip the cartridge top back in place. 
Note the front of the cartridge as you do this, 
making sure the tape does not slip on the 
outside of the 'window frames'. You now have 
an 8-minute cartridge, ready to use. 

If you end up with some slack tape hanging 
out of the cartridge, put on some thin cloth 
gloves. Now pull the tape out of the case gently 
from the end opposite the rubber puck. The 
tape will pull into the other end faster than it is 
being pulled out. When most of the slack is 
taken up, give a gentle tug with a bit of 'snap'; 
the momentum will spool the tape into the 
cartridge housing. 



If you are using the Craig H-240, the directions 
below will apply directly; since 8-track playback 
decks are similar, you can put some of them to 
use in remodeling your 8-track. It is also possible 
to purchase drives without electronics from 
surplus houses. These are sold for under $10, and 
come complete with head assembly, motor, and 
track-change solenoid. Be sure that you get one 
with a two-speed motor if you want to implement 
the fast forward features of the system; an 
excellent single-speed drive is sold for only $8 by 
BNF Enterprises. 

First of all, you should know that the deck 
won't be usable as an audio deck when you're 
done; so don't split up your hi-fi system in hopes 
that this 8-track storage system will serve double 
duty. 

1. Remove the case. Two screws hold the back 
panel, and screws through the four feet keep 
the frame attached to the housing. Set the 
back aside, and slide the electronics out 
through the front of the case. 

2. Pull off the buttons, and set them aside. 
Remove the four screws which hold the frame 
to the face plate, and set the face plate aside. 

3. Heat the soldering iron. You will be 
removing these wires: 

- The two wires connected to the on-off 
switch; contact is made when a cartridge is 
inserted in the deck. 

- The two wires from the foil sensor 
pickup. This is located about an inch from 
the on-off switch. 

- All wires running to the three switches 
underneath the deck. 



4. Remove the two front screws holding the 
three switches onto the front plate. Set this 
switch block aside; also remove all loose wires 
(those desoldered at both ends), and desolder 
the far ends of remaining wires which had run 
to the switches. 

5. Unscrew the electronics control board (two 
screws), which is found to the front of the 
transformer. Desolder all wires leading to this 
board, and discard the board, scavenge it for 
parts, or keep it. It is a legitimate 8-track 
preamplifier, and can still be used if you need 
such an animal. 

6. The following parts are still intact: 

- The motor and the three wires leading 
from it. These wires are still attached to a 
terminal strip. 

- The head assembly. This will be 
modified later. At present, it contains a 
shielded, three-wire cable leading from the 
playback head itself, and a five-wire 
assembly from the track-select switch. 

- The capstan, drive belt, and 
track-change mechanics. These-remain 
intact. 

- The transformer. Three wires run from 
it; the center tap (black wire), won't be used, 
so cover it with tape or a wire nut. 

- The terminal strip and two audio output 
jacks. These will be used. 

By removing these parts, you have returned 
the drive to its 'naked' state. If you are using a 
surplus 8-track drive, this is the condition in 
which it will be shipped. 

To use this in a digital system, several 
important conditions have to be met: 

1. The recording and playback must be done 
in a digital format. 

2. The track, splice, and tape-in-place status 
must be readable by the computer. 

3. Speed must be controlled by the 
computer. 



Figure 9-6. presents the complete circuitry to 
convert the Craig H-240 to a digital 
record/playback system. Incoming data is 
latched by Z12 on the occurrence of the 
command OUT (0AAH),A and is buffered by 
Z2a/b. It is fed to a symmetrical pair of 
output-coupled buffers (Zl and Z6). 



The Custom TRS-80 



221 



An 8-Track Mass Storage System 



Since the output of these CMOS buffers is 
capable of rising very high (within a few 
millivolts of the 12- volt supply voltage), this 
provides a fast rising pulse to the recording head. 
The data is recorded in a bipolar manner: that is, 
when buffers Zla/b rise, Zlc/d fall, and vice 
versa. 

This information is recorded directly on the 
tape. During playback, the raw waveform is fed 
to Z4a, an LF353 FET operational amplifier (a 
plug-in replacement for the more commonly 
available LM747, which can be substituted with 
some signal degradation). This amplifier is set 
up in an inverted configuration with high gain; it 
produces a strong waveform which is then fed 
into Z4b, configured as a high-gain 'clipping' or 
'squaring' amplifier (contributed by diodes Dl 
and D2). 

This output is stabilized and buffered by 
comparator Z5a, and fed to Z5b (Z5 is a simple 
LM 339 comparator), arranged as a TTL-level 
driver. Z3a, a three-state inverter, is connected 
directly to a TRS-80 data line. 



Figure 9-7 provides drive status information. 
ZlOe is hooked to the former cartridge on-off 
switch, informing the computer of the presence 
of a cartridge in the drive. The track select 
switches feed their 12-volt signals to ZIOa-b, 
which report the track pair in use. The foil sensor 
triggers a flip-flop made up of Z8a/b, which 
latches the fact that the foil has passed, until the 

computer resets it via the RESET SPLICE line. 

The unit is turned on from the front, and 
power is always applied to the electronics. When 
the program reads or writes to tape, the motor is 
turned on via data bit 5; for fast read search and 
write, the motor is activated by data bit 6. The 
splice status is reset via data bit 3, and tracks are 
changed via data bit 4. Writing to the deck is 
enabled by data bits 1 and 2 (for the upper and 
lower of the track pairs, respectively), and the 
actual data writing is done through data bit 0. 

Addressing of port AA is provided by Z14a-d 
and Z13, and this signal is combined with the 
computer's OUT and IN signals by Z8c/d. All the 
input data is latched by Z12. 




Figure 9-6. Schematic for 8- track storage system. 
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Figure 9-7. Schematic of tape player modification. 



The Custom TRS-80 



223 



An 8-Track Mass Storage System 




224 Chapter 9 



An 8-Track Mass Storage System 



Listing 9-4. 8- track load and save cartridge system. 



I 
E3 



7000 

7000 
7000 
7000 
7000 
0060 

7000 0A 

7001 00 
0001 
0055 
0001 
0002 
0004 
000B 
0010 
0020 
0040 
0001 
0002 
0004 
0008 
0010 
0020 
0040 

ooao 

7002 00 



7003 0E55 
7005 3E10 



10 OLS : REM * THIS PROGRAM PRINTS CURRENT 8-TRACK DRIVE STATUS 
20 0UTB5.16 : REM » START B-TRACK DRIVE BY SETTING OUTPUT BIT 4 
30 PRINT®0,"DATA 1: DATA 2:"i : REM * L & R TRACKS 

40 PRINT@1 28, "TRACK NO.:"; : REM * CURRENT HEAD POSITION PROMPT 
50 A=INP(B5J : REM » GET DATA FROM B-TRACK DRIVE AT PORT 55 HEX 
60 PRINT@66,[A AND 1281/128; : REM * TEST FOR HIGH DATA BIT 7 

TEST FOR HIGH DATA BIT & PRINT 
78HEX = 01111000 TRACK CONDITION 
REM * 01110000 = LO BIT 3 = TK1 
: REM » 01101000 = LOW BIT 4 =TK2 
HEM * 01011000 = LOW BIT 5 = TK3 
REM * 00111000 = LOW BIT 6 = TK4 
130 IF (A AND 4J=4 THEN PRINT e 256, "SPLICE DETECTED"; ; G0T01S0 
140 IF (A AND 2) =2 THEN PRINT 6 320. "CARTRIDGE IS IN » ELSE 

PRINT e 32D. "INSERT 'CARTRIDGE "; 
150 Q = HND(120) : REM * RANDOM TRACK SWITCH FOR TESTING ONLY 
160 IF B=Q THEN OUT 85, BO ELSE 3D : REM * SWITCH TRACKS HERE 
170 FOR N = 1 TO 100 : NEXT : OUT 85, 16 ; REM * RESUME NORMAL 
REM * RANDOM TRACK SWITCH COMPLETE; BACK TO START 
: AS=INKEYS : IFAS=""THEN190 : REM * OFF, THEN TEST 
: G0T030 : REM * TURN BACK ON WHEN ANY KEY PRESSED 
REM * HIGH-SPEED SELECT FOR TESTING PURPOSES ONLY 
* THIS ROUTINE CHECKS TOTAL CURRENT 8-TRACK STATUS 
: REM * SET Q VALUE AND TURN ON TAPE DRIVE 
GET CURRENT STATUS OF TAPE DRIVE FROM PORT 

REM * GET VALUE AT DATA TRACK 1 [BIT 7) 
REM * GET VALUE AT TRACK POSN 4 (BIT 6) 
REM * GET VALUE AT TRACK POSN 3 [BIT 5) 
REM * GET VALUE AT TRACK POSN 2 [BIT 4) 
REM * GET VALUE AT TRACK POSN 1 [BIT 3) 
: REM » GET VALUE OF SPLICE CONDITION (BIT 2) 
110 IF G=1 THEN OUT 85,0 : GOSUB 220 : REM * TURN OFF IF SPLICE 
120 H=[A AND 2)/2 : REM * GET VALUE IF CARTRIDGE IS IN (BIT 1) 
130 I=A AND 1 : REM * GET VALUE AT DATA TRACK POSN TWO [BIT 0) 
140 PRINTea,"D7 D6 D5 06 D3 D2 D1 DO"; : REM * PRINT DATA HEAD 
150 PRINT6Q+64,B;C;D;E;F;G;H;I ; REM * PRINT VALUES CALCULATED 



70 PRINT686 , [A AND 1 ) ; : REM 
80 B=(A AND 120) : REM * 120 
90 IFB=112THENPRINT@140,"1"; 
10D IFB=104THENPRINT@140,"2"; 
110 IFB=B8THENPRINT®140,"3"; 
120 IFB=56THENPRINT®140,"4"; 



180 GOT03D : 
1SD OUTB5.0 
200 0UTB5.16 
10 0UT254.2 : 
20 CLS : REM 
30 0=148 : 0UTB5.16 
40 A=INP(85J : REM • 
50 B=(A AND 1281/128 
6D C=(A AND 64J/64 
70 D=(A AND 32J/32 
80 E=(A AND 161/16 
SO F=[A AND BJ/B : 
10D G=(A AND 41/4 



16D PRINTS [Q+1 92 J 


"D 


T 


T 


T 


T 


S 


C 


D "; 


: REM * 


PRINT SOME 


170 PRINT® (0+256) 


"A 


R 


R 


R 


R 


P 


A 


A"; 


REM * 


PRETTY 


180 PRINT6(Q+320) 


"T 


K 


K 


K 


K 


L 


R 


T"; 


REM * 


WORDS 


190 PRINT6(a+3B4) 


"A 


t 


# 


# 


# 


C 


T 


A"; 


HEM * 


FOLLOW 


200 PRINT«Q+448) 


"1 


4 


3 


2 


1 


E 


N 


0"; 


REM * 


STATUS. 



210 GOT040 : REM * AND REPEAT THE PROCESS AS THE TAPE CONTINUES 
220 OUT 255,255 : OUT 255, : REM » A LITTLE SCREEN SHAKING 
23D AS=INKEY5 : IF AS="" THEN 220 : REM * TEST, LOOP IF NO CHAR 
240 0UTB5.24 : RETURN : REM * TAPE BACK ON, START PROCESS OVER 



00100 
00110 
00120 
00130 
00140 
00150 
00160 
00170 
00180 
00190 
00200 
00210 
00220 
00230 
00240 
00250 
00260 
00270 
00280 
00290 
00300 
00310 
00320 
00330 
00340 
00350 
00360 : 
00370 RDBYTE 
00380 WRBYTE 
00330 LEADER 
00400 LEADRD 
00410 DELAY 
00420 HOWMNY 
00430 VERFLG 
00440 VERFON 
00450 PORT 
00460 WRITEN 
00470 WRITEA 
00480 WRITEB 
00490 RESSPL 
00500 START 
00510 FSTFWD 
00520 CHANGE 
00530 READA 
00540 CARTIN 
00550 SPLICE 
00560 TRACKO 
00570 TRACK1 
00580 TRACK2 
00590 TRACK3 
00600 READB 
00610 STATUS 
00620 



SHORT 8-TRACK OPERATING SYSTEM FOR CONVERTED 8-TRACK 
TAPE DECK. FORMAT: 

ON, FAST FORWARD, FIND SPLICE, WRITE ENABLE, WRITE 
256 BYTES OF DIRECTORY ENTRY. LOOP UNTIL 10 ENTRIES ARE 
WRITTEN OR NUMBER TRANSFERRED FROM BASIC IS ACHIEVED. 
FILL OUT TRACK WITH FF'S, VERIFY WRITE [IF VERIFY FLAG 
IS ON), FIND SPLICE, CHANGE TRACKS, REPEAT PRyyESS FOR 
ALL FOUR TRACKS. 

DIRECTORY READ AT HIGH SPEED. ENTRIES ENTERED AT LOW 
SPEED IN 256-BYTE PACKETS. EACH PACKET HAS A NUMBER 
WHICH IS STORED IN THE DIRECTORY. NO DEFAULT ON TRACK 
OR DIRECTORY ENTRY IS ALLOWED. DIRECTORY ENTRY #0 IS 
RESERVED FDR FREE PACKETS ON EACH TRACK AND SECTOR. 
*** NOTE: THIS LISTING IS NOT A COMPLETE OPERATING 
SYSTEM. IT CONTAINS A SAMPLE DIRECTORY FORMATTING AREA 
AND SAMPLE HIGH-SPEED TAPE READ/WRITE ROUTINES. A FULL 
B-TRACK OPERATING SYSTEM IS AVAILABLE; WRITE TO: 
MSB ELECTRONICS. MR#1 DRAWER 766. BARRE, VERMONT 05641 
OR DETAILS. THE INFORMATION PRESENTED IN THIS LISTING 
IS FOR DEMONSTRATION, ALTHOUGH IT MAY BE ORGANIZED, 
TOGETHER WITH OTHER STANDARD SAVE/LOAD PARAMETERS , INTO 
A FULL OPERATING SYSTEM. *** 

tmmmmtmmttmmmtttMtmttttttttttmtt 



00630 

00640 

00650 

00660 

00670 

00680 

00690 AAAAAA 

00700 



ORG 7D00H 

EQU S . ; ***** REASSIGN TO READ BYTE 

EQU S ; ***** REASSIGN TO WRITE BYTE 

EQU S ; ***** REASSIGN TO LEADER WRITE 

EQU S ; ***** REASSIGN TO LEADER READ 

EQU 0060H ; DELAY VALUE IN ROM 

DEFB 100 ; 10 UNLESS BASIC XFER 

DEFB OOH ; TRANSFERRED FROM BASIC 

EQU 01 H ; STATUS REQUIRED BY TDS 

EQU 55H ; DEFINED AT 85 DECIMAL 

EQU 01 H ; DIO = HIGH FOR WR ENABL 

EQU 02H ; DI1 = HI/LO FOR WRITE A 

EQU 04H ; DI2 = HI/LO FOR WRITE B 

EQU 08H ; DI3 = HI TO RESET SPLCE 

EQU 1 0H ; DI4 = HIGH FOR MOTOR ON 

EQU 2DH ; DI5 = HIGH FOR FAST FWD 

EQU 40H ; DI6 = HIGH TO CHNGE TRK 

EQU 01 H ; DQO GOES HI/LO DATA A 

EQU 02H ; DQ1 GOES HIGH AT CARTIN 

EQU 04H ; DQ2 GDES HIGH AT SPLICE 

EQU 08H ; 003 GOES HIGH AT TRK 

EQU 1 0H ; DQ4 GOES HIGH A TRK 1 

EQU 20H ; DQ5 GOES HIGH AT TRK 2 

EQU 40H ; DQ6 GOES HIGH AT TRK 3 

EQU BOH ; DQ7 GOES HI/LO DATA B 

DEFB OOH ; COMPOSITE OF ABOVE 

USE CUSTOM INTERPRETER 

MMmmtmmmmm$t**tt*mtttttttw*tttwttt« 

START 8-TRACK DECK MOTOR RUNNING [GIVE IT ENOUGH TIME) 

#########«««######«######«# 



BASIC PATCH HERE 



LD 
LD 



C,PORT 
A! START 



START VALUE 

BITS SET TO START 

Listing Continued 



Figure 9- 8 presents the optional decoding of 
a ROM to contain the 8-track operating system. 
Notice that the decoding of the addresses is 
incomplete, so that data from 37C0 to 37FF must 
not be entered into the ROM to avoid bus 
conflict. The ROM should remain in its erased 
(all one's) condition in that memory area. 

Listing 9-4 is an operating system for the 
8-track storage system. It is made up of four 
major sections: 

1. Initialization. Patching the operating 
system into the BASIC interpreter. 

2. Formatting. The directory is set up past 
the splice on track zero in fast-forward 
mode. Each track is then written with 
program #1 headers. Because the tape is 
sequential, this is not a true disk-style 
directory. Instead, the directory stores the 
order and track number for each program, so 
that the correct track may be searched at 
high speed for its leader. 

3. Load Module. This accepts the 
command, checks for correct syntax and 
program type, activates the tape deck and 
searches for the program. 

4. Save Module. This module also accepts 
the command, checks syntax and program 
type, and writes the program to tape. The 
directory is updated. 

The most interesting aspect of the software is 
the method used for recording the data. After a 
start level, a low is written to tape. Each 
subsequent bit changes the level either once (a 
zero) or twice (a one). Clock bits are not used in 
this scheme. 

The operating system presented here is very 
basic, allowing only the elementary program save 
and load functions. However, data of all types 
may be stored in the system with additions to the 
software via additional commands. 

Several problems may initially be encountered 
in using this system: 

1. System does not respond. Make sure 
power is on; check for power to track lights. 
One should be lit. Find a cartridge which 
does not have its foil splice visible, insert the 
cartridge, switch to track 1 and PRINT INP 
(170). The value returned (in binary) should 
be xOOlOOOx. The x's are either one or zero, 
depending on the status of the data read 
outputs. Remove the cartridge. The value 
will change to xlOlOOOx. Switch to track 2, 
and replace the cartridge. Now it should 
read xOOOlOOx. 
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Continued Listing 



7007 F620 
7D09 320270 
700C QBFF 
700E ED79 
7010 10FC 



7012 1600 
7014 ED78 

701 6 BA 

7017 2800 
7019 3E40 
701 B 2A0270 
701 E B4 
701F 320270 
70 2S ED79 
7024 18EE 



7026 ED78 
7028 E604 
702A FE04 
70 2C 20FB 
702E ED78 
7030 E604 
7032 FE04 
7034 28FB 
7036 010010 
7039 CD6000 



703C CDD070 



703F 210070 

7042 AF 

7043 06FF 
7Q45 CD0070 

7048 F5 

7049 ED7B 
704B E604 
7040 FE04 
704F 2802 
7051 10F2 

7053 F1 

7054 3C 

7055 BE 

7056 30EB 



7058 3EFF 
705A CD0070 
7050 ED78 
705F EB04 
7061 FE04 
7063 20F3 



7065 14 

7066 7A 

7067 FE04 
7069 2819 



706 B 3E40 
706D 2A0270 

7070 B4 

7071 ED79 
7073 3E40 

7075 2F 

7076 2A0270 

7079 A4 
707A 010002 
7070 CD6000 

7080 ED79 
7082 18A2 



7084 3AD170 
7087 FE01 
7089 2036 



708B 1600 
70BD ED7B 
708F BA 
7090 2819 
7092 3E40 
7094 2A0S70 



00710 
00720 
00730 

00740 GOING 
00750 



00760 

00770 

00780 

00790 

00800 

00810 

00820 L00P1 

00830 

00840 

00B50 

00860 

00B70 

00880 

00890 

00900 

00910 

00920 

00930 

00940 

00950 

00960 JUMP1 

00970 

0QS80 

00990 

01000 JUMP1A 

01010 



OR 

LD 

LD 

OUT 

DJNZ 



FSTFWD 
(STATUS), A 
B.OFFH 
it), A 
GOING 



; GET INTO HIGH GEAR 
: PUT IT INTO PLACE 
; GET LONG LOOPS 
; START 8 TRACK 
; MANY TIMES FOR SURE 



HOVE TO TRACK ZERO, CHECKING STATUS OF TRACK EACH TIME 



LD 

IN 

GP 

JR 

LD 

LD 

OR 

LD 

OUT 

JR 



0,0 

A (C) 



Z,JUMP1 

A, CHANGE 

HL, (STATUS) 

H 

(STATUS) ,A 

(C),A 

L00P1 



TRACK VALUE TO CHECK 
CHECK TRACK VALUE 
AGAINST VALUE WANTED 
GO IF TRACK = 
TRACK CHANGE VALUE 
GET CURRENT STATUS 
CHECK PREVIOUS INFO 
AND PUT INTO PUCE 
CHANGE TRACK VALUE 
GO BACK UNTIL TRK = 



F W D..END,0F r TAPE .SPLICE,. .AND, DELAY. .Ig # |ET # PA # |T # |PLICE 



01020 
01030 
01040 
01050 
01060 
01070 
01080 
01090 
01100 
01110 
01120 
01130 
01140 
01150 
01160 
01170 
01180 
01190 



IN 

AND 

UP 

JR 

IN 

AND 

CP 

JR 

LD 

CALL 



m 



A.IC) 

SPLICE 

SPLICE 

NZ.JUMP1 

A,(C) 

SPLICE 

SPLICE 

Z.JUMP1A 

BC.1000H 

DELAY 



GET VALUE FROM PORT 
CLEAR ALL OTHER VALUES 
CHECK IF SPLICE DET'D 
BACK UNTIL. FOUND 
GET VALUE FROM PORT 
CLEAR ALL OTHER VALUES 
CHECK IF STILL SPLICE 
BACK UNTIL SPLICE OVER 
GET DELAY VALUE 
DELAY TILL GOOD TAPE 



####################################################### 
WRITE LEADER (NOTE: LEADER WRITE ROUTINE NOT INCLUDED) 



CALL 



LEADER 



WRITE LEADER 



FORMAT DIRECTORY (NOTE: THIS METHOD IS FOR EXAMPLE) 



L00P3 



L00P4 



01 200 L00P2 

01210 

01220 

01230 

01240 

01250 

01260 

01270 JMPX 

01280 

01290 

01300 

01310 

01320 

01330 

01340 

01350 

01360 

01370 

01380 

01390 

01400 

01410 

01420 

01430 

01440 

01450 

01460 

01470 

01480 

01490 

01500 

01510 

01520 

01530 

01540 

01550 

01560 

01570 

01580 

01590 

01600 

01610 

01620 

01630 

01640 

01650 

01660 

01670 

01680 

01690 

01700 

01710 

01720 

01730 JUMP2 

01740 

01750 

01760 

01770 

01780 

01790 

01800 

01810 

01B20 JUMP4 

01830 

01840 

01850 

01860 



*8r 

LD 

CALL 

PUSH 

IN 

AND 

CP 

JR 

DJNZ 

POP 

INC 

CP 

JR 



HL.HOWMNY 

A 

B.OFFH 

WRBYTE 

AF 

A,(C) 

SPLICE 

SPLICE 

Z.JMPX 

L00P2 

AF 

A 

(HL) 

NC.L00P3 



256 BYTES TO WRITE 
WRITE THEM IN PLACE 
SAVE ACCUM TEMPORARILY 
GET VALUE FROM DEVICE 
CLEAR ALL OTHER VALUES 
SEE IF SPLICE HIT 
GO IF SPLICE IS HIT 
ELSE ON TO NEXT BYTE 
RESTORE ENTRY VALUE 
UP TO NEXT ENTRY 
LAST ENTRY COMPLETED? 
OUT IF NOT DONE 



############m#########################«#######««« 
eiLL.WT.TJJAGK.HW^.KWLe.Y^E.^^SJ^J,,, 



##«#«#«###««################### 



LD 

CALL 

IN 

AND 

CP 

JR 



A.OFFH 

tw 

SPLICE 
SPLICE 
NZ.L00P4 



WHEN DONE GET ALL FF'S 
WRITE FF BYTE TO TAPE 
CHECK CONTENTS OF PORT 
MASK OUT OTHER BITS 
CHECK IF TO SPLICE 
IF NOT KEEP WRITING 



GET NEXT TRACK VALUE AND GET TRACK FORMATTING READY 

#####if##############################################»# 



INC 
LD 
CP 
JR 



D 

A,D 
4 
Z.JUMP2 



GET NEXT TRACK VALUE 
CHECK CURRENT VALUE 
IS IT FOURTH TRACK? 
IF NOT THEN BACK 



FORMAT NEXT TRACK, AND CONTINUE UNTIL PROCESS COMPLETE 



LD 

LD 

OR 

OUT 

LD 

CPL 

LD 

AND 

LD 

CALL 

OUT 

JR 



A, CHANGE 

HL, (STATUS) 

H 

(C),A 

A, CHANGE 

HL, (STATUS) 

H 

BC,200H 

DELAY 

(CTVA 

JUMP1 



GET CHANGE TRACK VALUE 
GET CURRENT STATUS 
STATUS PLUS CHANGE 
AND CHANGE THE TRACK 
GET CHANGE TRACK AGAIN 
SWITCH THE BITS 
GET THE STATUS 
STATUS PLUS CHANGE 
GET DELAY VALUE 
AND INVOKE THE DELAY 
AND TURN IT OFF 
AND GO BACK FOR MORE 



CHECK IF VERIFY FLAG IS ON (NOTE: ADD AS BASIC COMMAND) 

LD A.(VERFLG) ; STATUS. OF VERIFY FUG 

CP VERFON ; SEE IF FUG IS ON 

JR NZ.JUMP3 ; IF NOT THEN SKIP PAST 

MOVE TO THE FIRST TRACK, CHECK EACH AS IT PROGRESSES 

mimtmtmmtttmtttmtmtmtmtttttmmtt 



LD 
IN 
CP 
JR 
LD 
LD 



0,0 

AltC) 

D 

Z.JUMP5 

A.CHANGE 

HL, [STATUS] 



^y^O 



ST COUNTER TO ZERO 
GET STATUS FROM DECK 
CHECK AGAINST TRK 
IF, AT ZERO, THEN GO 
ELSE BEGIN TO CHANGE 
GET VALUE FROM STATUS 
Listing Continued . , 



2. Tracks do not switch. Check wiring to 
the solenoid, and that the 75452 is wired 
correctly. Listen to hear if the solenoid 
attempts to react (a light click or start). 
Remove the 75452 from its socket and short 
the free lead of the solenoid to ground. It 
should switch. Replace the 75452 if 
necessary. 



3. Programs do not load. If programs do not 
load at all, check the cartridge on an audio 
deck to see if something has been written. If 
not, go on to #4 below. If so, listen for 
occasional changes in pitch as the machine 
switches from fast forward to normal. 
Lengthen the speed change wait period in 
the program if you can hear the pitch slide 
as it restarts at a new level. If a loading 
message is displayed, but an error is 
detected, try to read from another track. 
Tracks la and 4b are at the edge of the tape, 
and lower-quality tapes may drop out 
occasionally in this area. The head may be 
badly misaligned and not make good contact 
with the tape. This can be heard as shifting 
or slewing in the sound. Adjust the Phillips 
alignment screw on the head to match a 
prerecorded commercial tape of good 
quality. 



4. Programs do not save. Begin the 
program-saving process, and place the signal 
lead of a small amp against one lead of the 
recording head. If the signal is present, the 
program should be saving. If not, check the 
wiring of the buffer IC's, which may not be 
letting the signal through. Also check that 
the software is entered correctly, and that a 
signal is actually being sent to the device 
(correct connection of the write line, and 
proper wiring of the address decoding and 
data latch). If the motor turns on and 
switches tracks properly, the signal is 
probably being held up by incorrectly wired 
buffers to the recording head. 

5. Motor speed does not change. Make sure 
that the third lead from the motor is being 
switched to ground, not positive voltage. 
This lead reacts best when switched below 
ground, and ground potential is its minimum 
position. If you have substituted another 
solid-state switch for the one shown, make 
sure it goes to full ground potential when 
switched in place. 
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Craig playback deck disassembled. Front panel main frame 
and feet are maintained but switch panel, playback electronics, 
wires, and buttons are discarded Front buttons maybe kept for 
appearance. 



Continued L, 

7097 B4 

7098 ED79 
709A 3E40 
709C 2F 
709D 2A0270 
70A0 A4 
70A1 01000E 
70A4 CD6000 
70A7 ED79 
70A9 10E2 



70AB 
70AD 
70AF 
7QB2 
70B5 
70BB 
7DB8 
70BA 
7DBB 
70BE 
70BF 



1E00 

06FF 

CD0070 

CD0070 

BB 

20 2B 

10FS 

1C 

3A0070 

BB 

20EC 



70C1 AF 
70C2 320270 
70C5 ED79 



70C7 
70CA 
70CD 
7000 
70E3 
70EB 
70E9 
70EC 



21D070 

CDA728 

C37B1D 

46 

21EC70 

CDA72B 

C3CC0B 

46 



isting 

01870 
01880 
01890 
01900 
01910 
01920 
01930 
01940 
01950 
01960 
01970 
01 9 B0 
01990 
02000 
02010 
02020 
02030 
02040 
02050 
02060 
02070 
02080 
02090 
02100 
02110 
02120 
02130 
02140 
02150 
02160 
02170 
02180 
02190 
02200 
02210 
02220 
02230 
02240 
02250 
02250 
02270 
02280 
02290 
02300 
02310 
02320 
02330 
02340 
02350 
02360 
02370 
02380 



OR 

OUT 

LD 

CPL 

LD 

AND 

LD 

CALL 

OUT 

JR 



H 

(C),A 
A, CHANGE 

HL, [STATUS) 

H 

BC.200H 

DELAY 

(C),A 

JUMP4 



AND CHECK STATUS VAL 
AND SEND OUT CHANGE 
GET VALUE AGAIN 
REVERSE THE BITS 
GET VALUE FROM STATUS 
GET VALUE FROM STATUS 
GET DELAY VALUE 
CALL DELAY IN ROM 
AND SEND OUT CHANGE 
AND GO DO THE REST 



VERIFY THE TAPE FORMATTING AND QUALITY IF FUG IS ON 



JUMP5 
L00P7 



L00P6 



LD 

LD 

CALL 

CALL 

CP 

JR 

DJNZ 

INC 

LD 

CP 

JR 



E,0 

B.OFFH 
LEADRD 
RDBYTE 

NZ.VERERR 
LOOPS 
E 
A.tHOWMNY) 

NZ.L00P7 



PACKET NUMBER TO START 
BYTE TO VERIFY WITH 
GET SYNC AND READ LEADR 
BEGIN READING THE BYTES 
AND CHECK FORMAT INFO 
IF NOT CORRECT, ERROR 
AND GO BACK UNTIL DONE 
GO TO NEXT PACKET 
CHECK IF FORMAT DONE 
BY GETTING PACKET # 
BACK IF NOT DONE 



STOP THE TAPE MACHINE AND CLEAR OUT ALL STATUS INFO 

munmmmunMmmmmnnmmmmmm 



JUMP3 



XOR 

LD 

OUT 



(STATUS), A 
tC), A 



CLEAR ACCUM TO ZERO 
PUT IN STATUS LOCATION 
AND SEND IT OUT PORT 



GET AND DISPLAY FORMAT COMPLETE MESSAGE (OR ERROR MSG) 



MESG01 
VERERR 



MESG02 



LD HL.MESG01 ; GET THE OKAY MESSAGE 

CALL 2BA7H ; LEVEL II DISPLAY ROUT. 

JP 1D7BH j BACK TO INTERPRETER 

DEFM 'FORMATTING COMPLETE' 

LD HL.MESGD2 j VERIFY ERROR MESSAGE 

CALL 28A7H ; DISPLAY SUBROUTINE 

JP OBCCH ; BASIC COMMAND LEVEL 

DEFM 'FORMAT ERROR' 



THESE ROUTINES MAY BE CALLED WITH THE /LOAD COMMANDS OR 
THE /SAVE COMMANDS, AS WELL AS THE FORMATTING ABOVE. 
NOTE: THESE ROUTINES USE AN EXCLUSIVE-OR METHOD OF 

Listing Continued . . . 



Construction and Checkout 

Since I recommend wire-wrapping the projects 
in this book, there are some different 
considerations when wrapping all the resistors 
and capacitors necessary for this project. 
Wire-wrapping is done best when there are 
sharp, square pins on which to wrap; since 
resistors and capacitors have round leads, it is 
best to insert these parts into sockets. Not only 
will the wrapping be more firmly attached, but 
the parts will not fall out when you are turning 
the board over during construction. 

Before beginning construction, note that the 
transformer installed in the Craig recorder is 
marginal; ideally, it should be replaced with a 12 
volt, 1.5 amp transformer of the type sold by 
Radio Shack. This will fit, though not 
comfortably, in the present transformer's 
location. The center tap is not used. 



Because there are mechanical and inductive 
parts in this device, a great deal of 
electromagnetic noise can be produced. Be sure, 
then, to do the following: 



1. Use bypass capacitors (.01 mF or so) 
between power and ground on every 
integrated circuit. 

2. Use bypass capacitors (.01 mF) on the 
75452 peripheral driver chips as noted, as 
well as diodes (hobbyist lN914's are fine) 
across the three relay coils. Leave the 
diode already present on the track change 
solenoid. Don't skip these parts; they 
make the difference between a working 
system and a continuous return to 
MEMORY SIZE. 

3. Use a central grounding point for all wires 
on the circuit board, and another central 
point for all wires on the drive. Don't weave 
wires from one IC to another. 

4. The resistors at the inputs of the CMOS 
chips (the 80C96 and 80C98s) are vital for a 
reliable signal, and also prevent damage to 
the chips themselves. 

5. The wires leading to the recording head 
should be twisted or shielded to prevent 
picking up extraneous signals. Remember 
also that the connections of the top and 
bottom pairs of pins on the head should be 
the same. 
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Continued Listing 

023SQ 



40F9 
OBCC 

70F8 F3 
70F9 2AF940 
70FC 3A3D40 
70FF E6FC 
7101 323D40 

7104 5F 

7105 7E 
71 0G 57 
7107 0B0B 
7109 3E01 
71 0B B3 
71 DC D3FF 
71 OE CD4371 

7111 AF 

7112 B3 

7113 D3FF 



7115 DDE5 
7117 DDE1 
7119 DDE5 
71 1B DDE1 
711D 00 
711E 00 



71 1F CD4E71 

7122 AA 

7123 E601 

7125 F5 

71 26 B3 

7127 D3FF 

7129 F1 
71 2A 2F 
71 2B EB01 
71 2D CD4E71 

7130 F5 

7131 B3 

7132 220000 

7135 DO 

7136 D3FF 

7138 F1 

7139 CBOA 
71 3B 10E2 



71 3D CD4E71 
7140 23 



7141 20C2 

7143 F5 

7144 C5 

7145 012SDD 



71 48 CD6000 
71 4B C1 
71 4C F1 
71 4D C9 

71 4E F3 
71 4F C5 
7150 D10300 



7153 CD6000 

7156 C1 

7157 F1 

7158 C9 



Loop 



02400 

02410 

02420 

02430 

02440 

02450 , 

02450 BOTTOM 

02470 BASIC 

02480 : 

0249D ENTER 

02500 

02510 

02520 

02530 

02540 

02550 ; 

025B0 NEXT 

02570 

02580 

02590 

D26D0 

02610 

02620 

0263D 

02640 

02650 

02660 

02670 

02680 

02690 

02700 

02710 

0272D 

02730 

027 40 

02750 

02760 

02770 

0278D 

02790 

02800 

02810 

02820 

02B3D 

02840 

02850 

02860 

02870 

02880 

02890 

02900 

02910 

02920 

02930 

02940 

0295D 

0296D 

D2970 

02980 

02990 

03D00 

03D10 

03080 

03D9D 

03100 

031 10 

03120 

03130 

03140 

03150 

03160 

03170 

03180 

03 190 

03200 

03210 

D3220 

03230 

03240 

03250 

03260 

03270 

03280 ; 

03290 : 

03300 DELAY1 

03310 

03320 

03330 

03340 

03350 

03360 

03370 

03380 

03390 

03400 

03410 

03420 : 

03430 DELAY2 

03440 

03450 

03460 

03470 

03480 

03490 

03500 

03510 

03520 

D3530 

03540 

03550 

03560 

03570 



RECORDING, WHICH WILL FUNCTION WITH A DIRECT DIGITAL 
RECORDING SITUATION SUCH AS THE 8-TRACK DEVICE. FOR 
FURTHER INFORMATION ON ITS OPERATION, ASK FOR THE 
OHIO SCIENTIFIC TAPE WAFER INTERFACE* SOLD BY MSB 
ELECTRONICS (ADDRESS ABOVE), AND EXAMINE THE CODE. 



EOU 
EQU 

01 

LD 

LD 

AND 

LD 

LD 



40F9H 
06CCH 



HL. (BOTTOM) 

A.1403DH) 

OFCH 

(403DH),A 

E,A 



BOTTOM OF BASIC PROGRAM 
RETURN TO READY MODE 

KILL THEM SUCKERS 
GET FIRST PROGRAM LOC'N 
VALUE IN THE MASK 
SET BIT TO ZERO 
PUT BACK INTO LATCH 
WILL BE USED A LOT 



LD 

LD 

LD 

LD 

OR 

OUT 

CALL 

XOR 

OR 

OUT 



A,(HL) 

D,A 

B B 

A 1 

E' 

(OFFH).A 

DELAY1 

A 

E 

(DFFH) ,A 



SPECIAL TEST (EXAMPLE) 
THIS IS THE BIG BUMPER 
NUMBER OF BITS TO WRITE 
THIS IS THE START BIT 
GET PROPER LATCH MASK 
WRITE OUT START LEVEL 
WRITE A START DELAY 
SET UP A WITH I/O BIT 
GET PROPER LATCH MASK 
WRITE OUT STARTING EDGE 



ADDING 66 T-STATES HERE TO TOTAL 95 US 



PUSH 

POP 

PUSH 

POP 

NOP 

NOP 



IX 
IX 
IX 
IX 



■STATES 
■STATES 
■STATES 
■STATES 
STATES 



T-STATES 



THIS IS SET UP FOR 3300 BAUD 

TOTAL LOOP TIME PER BIT SHOULD BE 300 US 

TOTAL T-STATES FOR EACH BIT LOOP = 169 = 95 US 

TOTAL T-STATES FOR BIT DELAY LOOPS AT 0060 NOTED BELOW 



CALL 



DELAY2 



WHITE A NORMAL DELAY 



XOR 

AND 

PUSH 

OR 

OUT 



D 

1 

AF 

E 

(OFFH) ,A 



TEST THE FIRST BIT 
MASK OUT OTHER D BITS 
SAVE THE VALUE 
VALUE OF LATCH MASK 
WRITE IT 



POP 

CPL 

AND 

CALL 

PUSH 

OR 

LD 

NOP 

OUT 



AF 



DELAY2 
AF 



(0000), HL 
(OFFH) ,A 



ORIGINAL VALUE BACK 
REVERSE THE BIT 
MASK OUT ALL BUT ONE 
WRITE A NORMAL DELAY 
SAVE THE PROPER BIT 
AGAIN GET THE MASK 
NEED DELAY TIME 
BIT MORE DELAY TIME 
WRITE IT 



POP 
RRC 
DJN2 



AF 

D 

LOOP 



GET ORIGINAL BITS BACK 
ORIENT TO NEXT BIT 
WRITE OUT B BITS 



XOR 
OR 
OUT 
CALL 

INC 



A 
E 

(OFFH), A 
DELAYS 

HL 



CLEAR ACC. TO ZERO 
GET MASK FROM 403D 
SEND OUT ZERO BIT 
SPACE OUT LAST BIT TOO 

GET NEXT MEMORY LOC'N 



#g##################################################### 



LD 
CP 
JR 
JP 

PUSH 
PUSH 
LD 



A.H 
40H 

NZ.NEXT 
06 CC 

AF 
BC 
BC.28H 



CURRENT MEMORY STATUS 
END? (EXAMPLE ONLYII) 
GO BACK IF NOT DONE 
READY (USE RETURN I J 

SAVE AF REGISTERS 
SAVE BC REGISTERS 
GET DELAY VALUE 



LINE ABOVE COMPLETES A TOTAL 1000 US DELAY LOOP 



CALL 
POP 
POP 
RET 

PUSH 
PUSH 
LD 



0060H 

BC 

AF 



AF 
BC 
BC.03H 



MAKE A DELAY 
RESTORE BC REGISTERS 
RESTORE AF REGISTERS 
BACK TO MAIN ROUTINE 

SAVE AF REGISTERS 
SAVE BC REGISTERS 
GET SHORTER DELAY VALUE 



LINE ABOVE COMPLETES AT TOTAL 205 US DELAY LOOP 



CALL 
POP 
POP 
RET 



0060H 

BC 

AF 



MAKE A DELAY 
RESTORE BC REGISTERS 
RESTORE AF REGISTERS 
BACK TO MAIN ROUTINE 



70FB 

00000 TOTAL ERRORS 

21490 TEXT AREA BYTES LEFT 



Position sockets as close together as possible 
so the final board will fit into the tape drive's 
case. Fill the board with sockets and parts, and 
test its size before beginning the wire-wrapping. 

Wire-wrap all connections completely before 
installing the 80C96 and 80C98 ICs. Because 
they are static-sensitive CMOS, they can be 
damaged by improper handling or application of 
power to partly-connected ICs. 

When construction is complete, install the 
ICs, connect the unit to the TRS-80, and apply 
power. 



— \ 




Detail view of Craig mechanics. Track change mechanism is 
operated by a spinning cog on the drive capstan (lower right). 
Four track change lights are illuminated by switch contacts to the 
rear of the playback head. 



ENTER 



AAAAAA 

BASIC 

BOTTOM 

CARTIN 

CHANGE 

DELAY 

DELAY1 

DELAY2 

ENTER 

FSTFWD 

GOING 

HOWMNY 

JMPX 

JUMP1 

JUMP1A 

JUMP2 

JUMP3 

JUMP4 

JUMP5 

LEADER 

LEADHD 

LOOP 

L00P1 

L00P2 

L00P3 

L00P4 

LO0P6 

L00P7. 

MESGO'I 

MESG02 

NEXT 

PORT 

RDBYTE 

READA 

READB 

RESSPL 

SPLICE 

START 
STATUS 

TRACKO 
TRACK1 
TRACK2 
TRACK3 
VERERR 
VERFLG 
VERFON 
WRBYTE 
WRITEA 
WRITEB 
WHITEN 



7003 
OBCC 
40F9 
0002 
0040 
0060 
7143 
71 4E 
70F8 
0020 
700E 
7000 
7053 
7026 
70 2E 
70B4 
70C1 
70BD 
70AB 
7000 
7000 
711F 
7014 
7D45 
7043 
7058 
70 B2 
70AD 
70D0 
70 EC 
7105 
0055 
7000 
0001 
0080 
0008 
0004 

0010 
7002 

0008 
0010 
0020 
0040 
70E3 
70D1 
0001 
7000 
0002 
0004 
D0D1 



00690 
02470 
02460 
00540 
00520 
00410 
03300 
03430 
02490 
00510 
00740 
00420 
01270 
00960 
01000 
01730 
02180 
01820 
02020 
00390 
004O0 
02860 
00820 
01200 
01190 
01360 
02050 
0203 D 
02290 
02330 
02560 
00450 
00370 
00530 
0060D 
00490 
D055D 

005DD 
00610 

00560 
00570 
00580 
0059D 
02300 
00430 
00440 
00380 
00470 
00480 
00460 



01560 01600 01850 01B90 
01650 01940 



02970 03170 



02100 
00990 01670 



02500 

00B50 
01050 
02620 
02860 
03570 
0071 D 
00750 
01170 
01250 
0OB4O 
01030 
01500 
01750 
01960 
01840 
01110 
02040 
03120 
00900 
01260 
01300 
01410 
02DB0 
02120 
02260 
02300 
03270 
00690 
02050 



0D970 00980 01010 01020 01230 01240 01380 

01400 

0070D 

00720 00860 00880 01570 01620 01860 01910 

02190 



02070 
01730 
01740 
01200 01370 
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And Now It's Broken 

It is not inevitable that your TRS-80 will fail 
during your lifetime, but there's always that 
chance. And if it happens, there's no reason to 
truck the computer down to the nearby 
Cost-a-Buck repair center. Do it yourself. This 
chapter will present the most likely failures or 
dilemmas you may encounter with your TRS-80, 
including: 

Setting up a reliable, crash-free 
environment in a typically casual home. 

Curing memory crashes in the CPU or the 
expansion interface, and replacing failed 
memory. 

Solving the garbage-on-screen power-up 
failure. 

Discovering the many sources of mysterious 
program crashes and keyboard lockup, and 
how to cure them. 

Aligning your video display to cure images 
off-screen, tearing or jitter. 

How program bugs can look like hardware 

failures, and vice versa. 

'Routine' maintenance - the hidden cure for 

many failures. 

Handling the computer and its peripherals. 

Overview of difficulties in disk drivers, 
cables, cassette devices, printers, RS-232 
boards, and other add-ons. 



A New Keyboard Cable 

Virtually every modification to the TRS-80 
contains a warning like this: 'Carefully open the 
case, and carefully take out the unit then 
carefully spread it out. Work carefully so as 
not to bust the keyboard cable'. So what's with 
the cable that makes it so fragile? The 
connections to the computer boards seem 
secure, but if you look carefully at the cable 
itself, you will see that it is made up of flat 
copper bands inside an insulating strip. The 
bands themselves are strong, and the 
connections to the computer are strong. 

The problem occurs at the point where the 
copper bands are clamped to the connectors 
that attach to the circuit board. Hairline 
cracks develop in the copper bands, separating 
them almost invisibly from the connecting pins. 
The only evidence of these cracks comes when 
odd combinations of letters appear sporadically 
while you are typing. 

If you plan to open the machine more than a 
half dozen times, you should replace the 
conection, with a 20-wire multiconductor cable 
or very flexible single conductor phono 
cartridge wire. 

First, cut the present cable off with shears, 
cutting at the point where the copper bands 
meet the connectors. Now, with generous 
amounts of solder-wick, remove the 40 



The Custom TRS-80 



229 



A New Keyboard Cable 












wife 
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Replacing the keyboard cable: Solder-wick and flux cleaner are 
used to remove all traces of the old connection cable. 



M?s^&| 




Replacing the keyboard cable: A new flexible cable is attached to 
both boards. A removable cable and connector can be used but 
the permanent flexible cable serves well enough once most 
modifications have been made. 



connectors on the keyboard and CPU board. 
Make sure all the copper is out of the holes, 
and clean what is surely to be a mess with flux 
remover, then buff the solder so new wires will 
slip easily through the holes. 

The new cable can be six inches long or more 
without affecting the operation of the unit. My 
own added keyboard, which is wired into place 
in the same manner as the original, has a 20 
foot cable and suffers no ill effects or program 
crashes. Cut and strip no more than one 
quarter inch of insulation off each end, and tin 
all 40 ends. 

Tinning is the process of running some hot 
solder onto the wire to prepare it for easy 
soldering to the board. The wire will remain 
the same diameter, the solder should not lump 
up, but will become smooth, hard and shiny 
with a solder coating. This will allow the wire 
to pass easily through the holes without 
random strands sticking out sideways and 
shorting against the neighboring connection. If 
the insulation creeps back from the heat, finish 
tinning all the ends and then clip them back to 
one quarter inch. 

Pass the multiconductor through all the 
holes in advance, and secure it temporarily 
with masking tape or other tape not affected by 
warmth. Getting all the wires through can be 
tricky, but accept the absurdity of the process 
in advance; outsiders tend to burst into 
laughter at the sight of a grown adult trying to 
thread 20 needles simultaneously, so if you 
can't take a joke, do this with the door locked. 

When all the wires are attached to either the 
keyboard or the CPU board (I recommend the 
keyboard first because it is lighter), check for 
shorts, then thread the cable through the other 
board. Solder, then look carefully for shorts 
before applying the power; both five volts and 
ground run through the cable, so be sure 
everything is well. 

Apply power. All characters should work 
properly, and no odd combinations of letters 
should be produced. If the power LED does 
not come on, either a connection was left off or 
you have a short. Power off immediately, and 
check again. If letters are missing, a connection 
was probably not made. If odd combinations of 
letters appear, you probably have a broken 
wire. If incorrect letters appear, you have 
switched wires. Once it's all working, you can 
ignore those 'carefully . . .' warnings and 
concentrate on the modifications to be made. 
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Home and 
Environments 



Small Business 



Computers are designed in laboratories, tested 
in laboratories, examined by engineers and run 
by programmers. There could hardly be a more 
unlikely manner of producing an appliance-type 
product like the TRS-80. When you unpack the 
home computer and plug it in, you begin a torture 
test unimagined by the professionals in their 
sleek, air conditioned factories. 

Below is a computer environment quick quiz; if 
you answer 'yes' to any question, your TRS could 
be in trouble. The more 'yesses', the more 
potentials for disaster: 

• Your computer and peripherals are 
plugged into extension cords or cube-taps. 

• A refrigerator, toaster, water pump, 
washer, dryer, or other large appliance is on 
the same fuse or breaker circuit as your 
computer. 

• You have an electric mixer, blender, or 
food processor which is used when the 
computer is used. 

• You have an electric drill, jigsaw, or table 
saw which is used when the computer is 
used. 

• Your computer table desk lamp is a 
push-on and hold fluorescent type. 

• You use your computer on or near a 
television set while the tv is turned on. 

• Your computer is used in the kitchen or 
shop, you or a family member smokes, or you 
heat with wood or coal. 

• You have fur-bearing animals in the house 
near your computer, especially cats. 

• Your power is supplied by a rural 
cooperative, or is generated by a local power 
company especially with low-head 
hydropower systems. 

• You live in an industrial area where heavy 
electrical equipment (winches, cranes) is 
used. 

• Your electrical thermostat is located near 
the computer. 

• Your home is especially dry, and you do 
not use a humidifier. 

• You live in a coastal area, or by a 
salt-water lake. 

• Your computer area is located near a 
railroad or by a highway traveled by heavy 
trucks. 



• You move your computer while it is on. 

Chances are you've got at least one check mark 
on the list above. Here are some solutions to 
these environmental problems: 

1. Plug your computer directly into a wall 
outlet, or use a commercial 'power strip'. 

2. Make sure that the computer is on a 
single-appliance circuit, even though it uses 
very little power. 

3. Brush-motor electrical appliances like 
mixers and drills create an enormous amount 
of electrical noise. Reach a compromise with 
the culinary artist or the shop craftsperson 
to use those tools at some other time, or at 
least far away from the computer. 

4. Use incandescent lamps, which send out 
virtually no electrical hash, and get rid of the 
fluorescent ones. Don't use a television for 

a computer table, because it creates heavy 
electromagnetic fields. And move the 
computer or the thermostat; there's a 
tremendous electrical noise jolt transmitted 
when that thermostat turns on. 

5. Keep smoke and grease of all kinds out of 
your computer's atmosphere, as well as 
animal (and people) hair. Tape and disk 
drives hate the stuff, and cables, connector, 
and keys build up greasy mudpiles because 
of them. 

6. If your power is unsteady because of an 
inept or unconcerned power company, or 
because local industry unexpectedly drains a 
large amount of power, you will have to 
install some sort of power regulator. Types 
such as Solatron, Mayday, and Topaz 
provide different qualities of regulation, at 
corresponding costs (see Appendix). 

7. Use a humidifier, or place pans of water 
on radiators or stoves if you house is 
especially dry in winter, because static 
electricity is quite powerful. If you live in a 
salt-air atmosphere, air-condition your 
computer area during warm, humid days. 
Salt air corrodes cables and connections. 

8. If railroads or trucks are nearby, cushion 
the computer. Vibration can cause noise in 
cables and especially the expansion box, and 
make disk reading and writing very 
failure-prone. Likewise, moving the 
computer (or even just pulling or straining 
the expansion or peripheral cables) can 
create bursts of electrical noise through the 
computer. Don't do it. Interestingly, even 
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pushing away a hard chair that vibrates on a 
linoleum or hardwood floor can cause disk 
read/write errors. And don't forget the 
dummy plug for CTR-41 tape recorders 
when saving programs! 

The home and small business environment is 
not often conducive to these suggestions, and 
some of them may not be necessary, depending 
on other factors. If you maintain your cables, 
edge card connectors, keyboards, etc., and keep 
your computer cushioned and seated on a 
conductive tabletop, you've gone a long way to 
increasing reliability. 

Furthermore, merely thinking of your 
micrcomputer in the same terms that used to be 
reserved for larger computers in the past 
(COMPUTER ROOM! NO SMOKING! . . . 
CAUTION! SENSITIVE ELECTRONIC 
EQUIPMENT! ... NO FOOD OR DRINK IN 
THIS ROOM!), then you have the right idea. 
Electronically, your TRS-80 can take a great deal 
of abuse and still function. But this abuse cannot 
take place while the computer is running. And 
that is the clue: treat your operating computer as 
if you were paying $50 an hour in time-sharing 
charges. 

When the Memory Crashes 

In early TRS-80's, memory crashes were the 
most prominent sort of failure. The type of 
memories used were the culprit, partly because of 
expansion box design problems, but especially 
because an unusual condition called the 'soft 
error' had not then been diagnosed. 

The 'soft error' was the tendency of a perfectly 
good program to crash with some error message 
when no such error was present. A simple 
CONTinue command would restore the system. 
These errors were caused by the internal 
structure of the memory chips themselves, 
which, because they are 'dynamic', use a peculiar 
and surprising principle for their operation. 

Memories maintain information. That is their 
job. 'Static' memories retain information so long 
as the power is applied to the computer. 
'Dynamic' memories, the type used in the 
TRS-80, retain their information for only a few 
thousandths of a second, requiring a electronic 
prodding, called refresh, to remember their data. 
They depend on their internal capacitance, 
acting much like a leaky tire. 

In the early days, this odd way of maintaining 
memory resulted in occasional erratic behavior, 
sometimes because the chip itself was flukey, and 
sometimes because normal low-level radioactive 



alpha-decay, present right on the base of the 
chip, could knock a memory bit from one state to 
another. This radioactivity is so delicate that a 
single sheet of paper can stop it. So this memory 
failure would occur only when the radioactive 
alpha particle actually struck a junction, and 
only when that junction was struck at precisely 
the right billionth of a second. Newer memories 
use a 'cool' base which does not emit alpha 
radioactivity, and so this rather bizarre problem 
has finally disappeared. 

But memory crashes still occur, and they come in 
a few major forms: 

Temporary crashes due to electrical noise in 
the vicinity of the computer. 

Temporary crashes in the expansion 
interface due to a badly attached or 
otherwise noisy set of refresh lines. 

Temporary crashes due to improperly 
seated or corroding memory chips. 

Permanent crashes due to bad memory 
chips. 

Repairable crashes due to a damage to one 
of the three lines responsible for memory 
refresh. 

Electrical storms. I'll digress just a 
moment on this one. During a summer 
meeting of the Vermont Computer Guild, an 
electrical storm approached rapidly. We 
began to engage in a sly but nervous game of 
electronic chicken, leaving our micros not 
only attached to the power, but running! 
Naturally, that was too much of an 
invitation to Mom Nature, who zapped our 
very power line with a basketful of 
megavolts. My TRS-80 kept working; 
another hung, but reset. An Apple winked 
and sighed, and its memory cleared. A KIM 
turned tail completely, taking with it video 
routines and all. And the expensive DEC 
PDP/11 was broiled, losing more than a 
handful of expensive chips. Moral: You 
know it. 

Also, there are crashes which appear to be 
memory crashes when they are in fact otherwise. 
Among these: 

A wayward program containing errors in 
PEEK or POKE statements, or machine 
language subroutines. 

A damaged CPU chip or blown buffer chip. 

A cracked circuit board trace, solder ball, or 
solder splash. 
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Cleaning the Edge Connectors 

The expansion connector on the back of the 
CPU, and the various ports around the 
expansion interface, were all manufactured 
using a solder coating instead of gold plating. 
Because solder is lead, and lead tends to 
corrode badly, these connections will inevitably 
get electrically rroisy. 

Cleaning them is quite easy, and should be 
done, depending on your environment, from as 
often as weekly to a minimum of monthly. 

Turn the equipment off and remove all 
cables. Check the edges of the cables for 
internal bend pins, hairs, or other damage or 
obstructions. Next, remove the top and bottom 
of the keyboard and expansion interface cases; 
if you don't wish to go inside your computer, 
this process can still be done, although it is 



awkward. 

Using a new dollar bill, a piece of the finest 
grade of emery paper, or a fine talc buffing 
wheel, bring the contacts to a bright shine. 
Brush off any remaining particles, and spray 
with contact cleaner (sometimes called tv tuner 
cleaner). Repeat this for all the edge 
connectors, and reinstall the cables. 

If this process is repeated regularly, 
interconnect noise problems will be completely 
eliminated. However, if cables slide along the 
contacts when the computer is in use, noise 
may still be produced. To cure this, place no 
strain on the cables, and replace the keyboard 
expansion cable with a longer, more flexible 
unit. If your TRS-80 uses the buffered cable, 
instead of replacing it, merely add to it with 
one of the cable extenders sold by Exatron and 
others (see Appendix). 



There are two software tools which can be used 
to eke out memory problems: the memory test 
printed in Chapter 3 , and MEMORY SIZE? 
itself. Running the memory test will describe 
which memory locations and chips may be bad. 
When the MEMORY SIZE? question is 
answered with only a carriage return, a Level II 
subroutine begins testing each memory location 
until it finds a bad one; that final non-memory or 
bad memory location is found by typing: 




Photo 10-1. Power supply transistors. 



In a 16K machine, the value returned should 
be 32768. If it is less, then the value returned is 
a bad memory location. Since the MEMORY 
SIZE? test is simplistic, it will not identify all 
possible memory errors, and if you suspect one, 
run the memory test. 

If the bad memory location seems to move 
about, then perhaps it is not a true memory 
problem at all, but rather due to bad connections 
or electrical noise. Be sure noisy electrical 
equipment is not located near the computer. 
Clean cable and edge card connectors (see Box), 
and see if the problem recurs. If it does, open the 
case of your keyboard unit (and expansion box), 
and remove and reseat each memory chip. Look 
for corrosion, especially on newer chips without 
gold-plated leads. 

If the problem is still not cured, the difficulty 
may be in the power supply. The location to 
suspect first is the large transistor (Q 4 - see 

Photo 10-1 ), which is screwed down to the 
circuit board. Corrosion can build up between 
this transistor and the solder-plated circuit 
board. Loosen and remove the screws that attach 
the transistor, but do not attempt to remove the 
transistor itself. Slide fine emery paper - 
definitely not steel wool or sandpaper - face 
down between the transistor and the board, and 
clean out any corrosion. 

If a lockwasher was not used between the 
transistor and the board, insert one, and reinstall 
and tighten the screws. This should stabilize the 
power supply inside the case. 
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Using an Oscilloscope 

The oscilloscope is a very sophisticated tool, 
but in this book it is used for an elementary 
purpose: merely to see if a signal is 'there' or 
not, and if it looks pretty good. Almost all 
TRS-80 circuitry failures can be traced this 
way, and it requires no previous experience 
using an oscilloscope, and no special training in 
reading waveform timings. 

The height of an oscilloscope screen trace 
changes in proportion to the signal present at 
its input. To see this, plug in the scope, turn it 
on, and adjust the intensity until a flat line is 
visible in the center of the display. Attach its 
cables to the vertical input. Leaving the 
ground (black) wiring hanging, hold the signal 
(red) wire in one hand. The flat line displayed 
on the screen should go wild. 

Adjust the vertical calibration (or voltage 
range) until you can see the trace. Adjust the 
sweep, sweep vernier and synchronization 
controls until the trace stabilizes, and looks like 
this: 



MlA\n 



Photo 10-3. Photo of sine wave. 

Adjust the vertical and horizontal centering 
until the trace is in the center of the screen. 
What you see is your own body acting as a kind 



of transformer, soaking up all the electrical 
signals from the wiring and equipment all 
around you. 

Now hold the black ground wire in your 
other hand. The wild trace should now flatten 
out considerably, as you become both signal 
and ground, essentially 'shorting out' the bulk 
of the signal received by the oscilloscope. 

Next, power down your TRS-80 and open it. 
Using clips or by soldering a wire temporarily 
into place, attach the black ground wire to the 
point shown in the photo below: 

Hold onto the red cable, and power-up the 
computer. Now find pin (?) of the Z-80 
microprocessor (Z40 on the circuit board), and 
hold the red probe to it. Adjust the screen so 
you can see all of the trace, and it consists of a 
regular series of pulses. 



Photo 1 0-5. 1. 77 MHz clock pulses. 

What you are looking at is the actual 
1,774,000 pulse per second master clock of the 
TRS-80. All the signals you see throughout the 
computer should be of this quality - 
sharp-edged and clean. They will not have the 
same regularity, because different lines are 
turned on and off only as needed. But the 
signals should always be of the same crispness. 



Photo 10-4. Photo of TRS-80 ground point for scope. 



For practice, place the red probe at various 
points on the computer, being very careful not 
to short two points together with the tip of the 
probe. You will see the many kinds of signals 
present throughout the computer. If your 
computer has a problem, you will be looking for 
signal lines which have failed: they will be 
rounded, or angled instead of vertical, or will be 
much lower in level than the ones you see now. 
This is a clue to the area of the failure. I 
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The next step is to switch the external black 
power supply box with a new one, because your 
present supply may have a damaged, highly 
resistive, or intermittent fuse wire. Later 
supplies can be opened to check this; there are 
screws under the feet. If the new supply works, 
have the old one repaired, or open it yourself and 
replace the fine fuse wire with a new one. 

Memory problems caused by damaged refresh 
lines are subtle, but can be discovered. Load a 
BASIC program, LIST it, and re-LIST it. If 
gradually the program shows changes, suspect 
that the refresh lines may be weak. To diagnose 
this job fully, you will need an oscilloscope. 

Photo 10-2 shows how cleanly a good signal is 
represented on the scope screen. Anything less 
than a sharp-edged, rectangular pulse should be 
suspect. Furthermore, a signal that is distinctly 
lower than others can be suspected. 
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Photo 10-2. Digital scope photo. 



Aligning the Video 

Video jitter in most cases is due to incorrect 
settings of either the vertical or horizontal 
controls on the back of the monitor itself. To 
align these, enter the following short program: 

10 CL£ 

20 FOR X = 15360 TO 1B3B3 

30 POKE X.191 

40 NEXT 

50 GOTO 50 

Listing 10-1. Video centering routine. 

This will paint the screen white. Any bulging 
on either side of the screen can be cured by 
adjusting the horizontal control on the back of 
the monitor. Turn it until the bulging is reduced 
as much as possible. Instability or rolling is most 
easily cured by adjusting the vertical control on 
the back of the monitor. 'Zero' it in by making 
the screen first roll forward, then back, then 
forward, and back again until you have what feels 
like the central position of the control. 

Open the TRS-80, and set the program above 
in motion again. The horizontal and vertical 
positioning controls are located at the far right of 
the circuit board as shown in Photo 10-1. 
Adjust these until the image is properly centered, 
and drop a very small amount of glue or nail 



polish on the control's plastic handle to hold it in 
that position against the control's body. 

Any remaining instability in the screen display 
can usually be attributed to low voltage present 
on your house current line, or problems with the 
TRS-80 power supply (see above). 

Routine Maintenance 

Microcomputers like the TRS-80 are generally 
thought of as maintenance free, except for 
peripherals with moving parts. But in truth, the 
keyboard unit and expansion box always need 
some maintenance, all of which is covered 
throughout this book. In summary: 

1. Clean edge card connectors and check 
cables regularly. 

2. Remove keytops (only on units with the 
older keyboards susceptible to keybounce) 
and blow out dust and clean contacts 
regularly. 

3. Blow out dust from the unit itself, and 
give it a shake, to remove any solder balls 
and splashes that may come loose as the unit 
gets older. 

4. Keep the unit covered when not in use. 

Care of Peripherals 

Cassette players. Using ordinary rubbing 
alcohol and cotton swabs, clean the head, capstan 
and pinch roller to remove all traces of brown 
tape oxide. Demagnetize the head using a 
commercial demagnetization cassette, or a head 
degausser (available at Radio Shack); follow the 
directions carefully so you don't make the 
problem worse. 

Always handle the player's buttons gently, as 
snapping them vigorously will not only shorten 
their life, but create enough vibration to throw 
the head out of alignment. If the head does get 
misaligned, or you suspect it is, turn to the details 
of cassette player maintenance in Chapter 6. 

In summary: clean all parts that come in 
contact with tape, and treat the unit's controls 
gently. 

Printers. Dot-matrix types like the Radio 
Shack line printers are workhorses, but there are 
a few cautions. First and foremost, never move or 
remove paper when the printer is in motion. The 
printed characters are formed by fine wires 
striking against the paper, and these wires can be 
bent if the paper is pulled against them. 

Keep ribbons in good condition, because a 
ribbon with a slight tear can also catch on a head 
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and damage the dot-matrix wires. Open the 
printer and blow out dust and dirt regularly; if 
you are skilled in handling small machinery, 
lubricate the printer according to the Radio 
Shack maintenance manual. If you are a klutz, 
don't try; alignment of printers has to be accurate 
to l/100th of an inch. 

In summary: keep printers free of dust and 
ribbons fresh. 

Disk Drives. These horrors are terribly 
sensitive. Like tape machines, the heads need 
cleaning, but use only head cleaning diskettes 
especially made for the purpose. If you have 
regular data read/write problems, there are 
several solutions: purchase a better disk 
operating system (DOS), and/or purchase and 
install an external data separator. 

Keep out of the drive's insides as much as 
possible. Alignment is sometimes vital, but 
again, unless you are very good with precision 
machines, don't try it yourself. And even if you 
are a born watchmaker, be overly careful with 
double-sided or double-density drives. 

In summary: beyond a regular cleaning, leave 
them alone. Oh yes, keep the drive cables well 
away from the monitor or any AC power cables. 

Exatron Stringy-Floppy. Despite the 
manufacturer's warnings, this unit does not come 
well aligned from the factory, and many units 
were shipped without head alignment cement 
(normally Lok-Tite, a grey compound) to hold 
heads firmly in place. Remove the cover of the 
unit and check for this gop. If it is not there, turn 
to Chapter 9 and follow the alignment 
directions. 

If the gop is not there, you'll need an oscilloscope. 
Turn the scope on, and adjust the vertical calibra- 
tion for full scale (maximum). Hook the scope's 
ground (black) lead to a convenient ground point 
on the ESF or the TRS-80, and place the hot (red) 
probe on Z6 — pin 7. Start the ESF reading a 
prerecorded tape from the manufacturer. If the 
wave won't stay in synchronization on the screen, 
or if it is outside the vertical bounds of the screen, 
adjust the scope until it is visible and stable. With 
a small screwdriver, adjust the playback head's 
alignment until the amplitude (height) of the 
waveform is at its maximum. Try several pre- 
recorded tapes to make sure of this position, and 
put some lok-tite on it. If you have your own tapes 
recorded on the ESF, you may have to move back 
and forth to and from the correct position, reading 
in the original position, and re-recording in the 
corrected one. 



Clean the heads and capstan with a very 
sparing and gentle application of rubbing alcohol 
on the end of a lint-free swab. Don't use Q-tips or 
their equivalent, but rather wrap surgical gauze 
around a lollipop stick. Blow dust out of the unit 
regularly. Remember never to operate the ESF 
in any position but on its feet. 

In summary: blow out dust, clean heads, and 
check for the presence of 'Lok-Tite' on the head 
screws. 

RS-232 Board. In another piece of dream 
engineering, the connection of this board to the 
expansion box was done via a flukey, 
solder-coated connector board pressed against a 
plastic bridge with plain metal contacts. Clean 
those contacts regularly with a fine cloth, and 
brush the solder-coated board connectors 
vigorously with a buffing cloth or extra-fine 
emery paper. Spray both sparingly with tuner 
cleaner, and quickly reattach them, constantly 
rocking the board to assure a firm connection 
until you have tightened the screws down. 

In summary: clean both sets of contacts 
occasionally, especially if you notice more than 
the usual transmission/reception errors. 

Diagnostic Programs and Loops 

Loading large-scale programs for diagnosis is 
not only time-consuming, but as often as not 
impossible when your computer is not working 
well. If BASIC can be brought up at all, then 
simple machine language diagnostics can be 
POKEd into place from command level. This 
section will present several of those loops, their 
use in trapping some of the possible difficulties, 
and how they can be used to examine the 
operation of the system. All these routines can be 
POKEd anywhere in your machine's memory; 
these examples all start at 5000 (20480 decimal). 

1. Checking the Write Circuits. 

This routine merely writes to a location and 
jumpsback to itself: 



Coding: 






AF 


XOR 


A 


32 00 3C 


LD 


(3C00) ,A 


3C 


INC 


A 


18 FA 


JR 


S-4 



Listing 10-2. Write circuit diagnostic/machine. 

From BASIC: 

X=2D480:POKEX,175:POKEX+1,50:POKEX+2,0:POKEX+3,60: 
P0KEX+4,60:P0KEX+5,24:P0KEX+6,250 <ENTER> 

SYSTEM <ENTER> 

/20480 <ENTEB> 



Listing 10-3. Write circuit diagnostic/BASIC. 
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This routine will write the value in A, which is 
incremented from 00 to FF (0 to 255) each time 
the loop is passed through. The write line will 
pulse each time the LDd (3C00),A instruction is 
commanded. The first position on the video 
screen will flicker, as this is the memory location 
being written to. Press the Reset button to return 
from this routine. 



2. Checking the Read Circuits. 

Since each instruction must be fetched, this is 



4. Checking the Input Circuits. 

This routine is similar to the write routine, but 
does not include any accumulator changes. 



Coding: 






DB DO 


IN 


A, (00) 


18 FG 


JR 


$-2 



only a simple loop: 



Listing 10-8. Input circuit diagnostic/machine. 

From BASIC: 

X=2Q4B0:P0KEX,219:P0KEX+1,0:P0KEX+2,24: 
POKEX+3,252 <BITER> 

evctcm <ENTER> 

/aSiio <en ter > 

Listing 10-9. Input circuit diagnostic/BASIC. 



Press the Reset button to return from this 
routine. 



<ENTER> 
<ENTER> 
<ENTER> 



Coding: 

18 FE JH * 

Listing 10-4. Read circuit diagnostic/machine. 

From BASIC: 

P0KE20480,24:P0KE20481 ,254 
SYSTEM 
/204BD 

Listing 10-5. Read circuit diagnostic/BASIC. 

The Read line will pulse four times for every 
loop through this routine: twice for each 
instruction fetch, and twice for each refresh 
action. Press the Reset button to return from 
this routine. 

Listing 10-6. Output circuit diagnostic/machine. 

3. Checking the Output Circuits. 

This diagnostic is very much like that for 
examining the Write line, except that it triggers 
the Out line. 



Coding: 






AF 


XOR 


A 


D3 FF 


OUT 


IFF), A 


ac 


INC 


A 


18 FB 


JR 


S-3 



From BASIC: 

X=20480:POKEX,176:P0KEX+1 ,211 :P0KEX+2,2SS:P0KEX+3,60: 
P0KEX+4,24:P0KEX+5,251 <ENTER> 

SYSTEM <ENTER > 

/20480 <ENTER> 

Listing 10-7. Output circuit diagnostic/BASIC. 

Each time the loop is passed through, the OUT 
line will be pulsed once, and the data present on 
the data lines will be incremented. This routine 
is also very useful because the cassette relay, the 
cassette data output, and the video screen will all 
demonstrate activity as the routine is looped 
through. Press the Reset button to return from 
this routine. 



5. Checking the HALT Line. 

Since the HALT line is gated together with the 
Reset button, executing HALT should return to 
ready (or reboot in a disk system). 



Coding: 
76 



HALT 



Listing 10-10. HALT line diagnostic/machine. 



From BASIC: 
POKE20480,118 
SYSTEM 
/20480 



<ENTER> 
<ENTER> 
<ENTER> 



Listing 10-11. HALT line diagnostic/BASIC. 

Since the machine should return to READY, 
the Reset button need not be used. 



6. Checking the Video. 

This routine presents a screen full of 
characters, all identical, and increments through 
all 256 of the possible characters. With no lower 
case modification the screen will display three 
sets of upper case characters, followed by two 
sets of graphics characters. With a lower case 
modification, two upper case sets and one lower 
case, or one of each case plus a set of control 
characters will be displayed. 



Coding: 






AF 


XOR 


A 


21 00 3C 


LD 


HL.3C00 


11 01 3C 


LD 


DE.3C01 


01 FF 03 


LD 


BC.03FF 


77 


LD 


(HL),A 


ED 80 


LOIR 




3C 


INC 


A 


F5 


PUSH 


AF 


01 00 CO 


LD 


BC.COOO 


CD 60 00 


CALL 


0060 


F1 


POP 


AF 


18 E9 


JR 


$-21 D 



Listing 10-12. Video routine diagnostic/machine. 
The Custom TRS-80 
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From BASIC: 

X=204BQ:POKEX,175:PQKEX+1,33:PQKEX+2,0:POKEX+3,60: 
P0KEX+4,17:P0KEX+5,1 :P0KEX+6,60:PQKEX+7,1 : 
P0KEX+8,255:P0KEX+9,3:P0KEX+10,119:P0KEX+11,237: 
P0KEX+12,176:P0KEX+13,60 <ENTER> 

P0KEX+14,245:P0KEX+15,1:P0KEX+16,0:PQKEX+17,192 
POKEX+18 ,205:PDKEX+19 ,96 :P0KEX+20 ,0:P0KEX+21 ,241 
P0KEX+22,24:P0KEX+23,233 <ENTER> 

SYSTEM <ENTER> 

/2D4B0 <ENTER> 

Listing 10-13. Video routine diagnostic/BASIC. 

Also, the VID* line (noted on the schematic in 
the Technical Reference Handbook) should 
pulse in very noticeable groups as each screen is 
printed. Use the Reset button to exit this 
routine. 



From BASIC: 

X=20480:P0KEX,62:P0KEX+1,65:P0KEX+2,50:P0KEX+3,232: 
P0KEX+4,55:P0KEX+5,1:P0KEX+6,0:P0KEX+7,48: 
POKEX+8 , 205 : POKEX+9 , 96 : POKEX+1 , D : POKEX+1 1 , 24: 
POKEX+12,243 <ENTER> 

SYSTEM <ENTER> 

/2D480 <ENTER> 



Listing 10-1 7. Printer diagnostic I/BASIC. 



Print-and-Wait Routine 



Coding: 
3E 41 
21 E8 37 
77 

CB 76 
20 FE 
18 F4 



LD 

LD' 

LD 

BIT 

JR 

JR 



A, 41 

HL.37E8 

(HL),A 

6.1HLJ 

NZ,$ 

S-10D 



7. Checking the Cassette Output. 

This routine calls the byte-output routine, and 
should write an FF (equal to eight timing pulses 
and eight data pulses) to port FF (the cassette 
output). 



Coding: 
3E FF 
CD 35 02 
1B F9 



LD 

CALL 

JR 



A, OFF 

0264 

S-S 



Listing 10-14. Cassette output diagnostic/machine. 

From BASIC: 

X=204B0:POKEX,62:PQKEX+1,255:P0KEX+2,2O5:POKEX+3,100: 
P0KEX+4,2:P0KEX+5,24:P0KEX+6,249 <ENTER> 

SYSTEM <ENTER> 

/204B0 <ENTER> 

Listing 10-15. Cassette output diagnostic/BASIC. 

You should be able to measure (or hear) a 
constant group of pulses output to the cassette 
player. Note that the cassette player must be in 
record position, and must be running (the small 
plug must be removed) because this routine does 
not turn the cassette machine on. Use the Reset 
button to exit this routine. 



8. Checking the Printer. 

By writing data to address 37E8, the printer 
should react by printing that character. The 
following two routines output the letter 'A' to the 
printer; the first loops through a delay, 
outputting about five characters per second. The 
second waits for a printer handshaking signal. 

Print-and-Delay Routine 



Coding: 






3E 41 


LD 


A, 41 


32 EB 37 


LD 


(37EB) ,A 


01 00 30 


LD 


BC.3000 


CD 60 00 


CALL 


006Q 


18 F3 


JR 


5-110 



Listing 10-18. Printer diagnostic IJ/machine. 

From BASIC: 

X=20480:P0KEX,62:P0KEX+1 ,65:P0KEX+2,33:P0KEX+3 ,232: 

P0KEX+4,55:P0KEX+5,119:P0KEX+6,203:P0KEX+7,118: 

POKEX+B,32:POKEX+9,254:POKEX+10,24:POKEX+11,244 

<ENTER> 
SYSTEM <ENTER> 

/20480 <ENTER> 

Listing 10-19. Printer diagnostic II/BASIC. 

9. Checking the Interrupt Line 

For this, of course, interrupt hardware must be 
attached to the system. In the case of the 
expansion box, the interrupt flip-flop must be 
cleared (see Supplement to Chapter 4). This 
routine performs that function. It is identical to 
the first service routine presented in the 
Supplement to Chapter 4, and so only the BASIC 
coding is presented. 

From BASIC, attempt to use this program 
instead of direct POKEs, because there are so 
many values: 

10 FOR X = 20480 TO 20926 : READ A : POKE X,A : NEXT 

2D STOP 

30 DATA 243,62,195,50,18,64,33,20,50,34,19,64 

40 DATA 33,25,26,229,237,86,251,205 

50 DATA 243,245,229,213,197,58,236,55 

60 DATA 58,224,55,33,17,1,17,37,62,1,26,0 

70 DATA 237,176,193,209,225,251,201 



SYSTEM 
/20480 



<ENTER> 
<ENTER> 



Listing 10-20. Interrupt line diagnostic/BASIC. 

This routine, as described, returns to BASIC 
command level and displays a RADIO SHACK 
LEVEL II BASIC message continuously on the 
screen. 



Listing 10-16. Printer diagnostic I/machine. 
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10. Checking Speed Modifications 

Among the possible high speed failures are 
miswirings, ROMs which are two slow, and 
RAMs which are too slow. Combinations of these 
can make diagnosing a locked-up computer very 
frustrating. 

The two routines below test, respectively, 
RAM calling ROM, and RAM alone. The RAM 
routine may be moved to higher memory for 
testing that area; a version at 5000 and B000 are 
provided. 

Coding: 
RAM-Resident Version - Origin is at 5000 



32 60 


3D 


LD 


(3060), A 


3C 




INC 


A 


F5 




PUSH 


AF 


AF 




X0R 


A 


D3 FE 




OUT 


(FE) ,A 


F1 




POP 


AF 


32 61 


3D 


LD 


C3D61),A 


F5 




PUSH 


AF 


3E FF 




LD 


A,FF 


03 FE 




OUT 


[FE),A 


01 00 


10 


LD 


BC10D0 


0B 




DEC 


BC 


78 




LD 


A,B 


B1 




OR 


C 


20 FB 




DJNZ 


FB 


F1 




POP 


AF 


C3 00 


50 


JP 


5D00 


ROM-RBSldent 


Version 





Remove Lines marked (*) and replace with: 
CD 6D 00 CALL 0060 

High RAM-Resident Version 



Origin is at B000; replece line marked (%) with: 
C3 DO BO JP B000 



Listing 10-21. High-speed modification diagnostic machine. 

RAM/ROM Version 

Remove lines marked (*) and replace with: 

High RAM-Resident Version 

Origin is at B000; replace line marked with 
percent sign with: 

Since speed changes can affect the operation of 
BASIC, a version with POKE may be useless; if 
not, however, here is the RAM-resident version: 

X=20480:P0KEX,50:P0KEX+1,96:P0KEX+2,61:P0KEX+3,60: 
P0KEX+4,245:PDKEX+5,175:P0KEX+6,211:P0KEX+7,254: 
P0KEX+B.241 :P0KEX+9,50:P0KEX+10,97:P0KEX+11 ,61 : 
P0KEX+12,60:P0KEX+13,24S:P0KEX+14,62:P0KEX+15,255: 
P0KEX+16,211:POK.EX+17,254:P0KEX+18,1:POKEX+19,0: 
POKEX+20,16 <ENTER> 

POKEX+21 ,11 :POKEX+22,120:P0KEX+23,177:POKEX+24,32: 
POKEX+25,251 :P0KEX+26 ,241 :P0KEX+27 ,195:P0KEX+2B,0: 
POKEX+29,80 <ENTER> 

Listing 10-22. High-speed modification diagnostic BASIC. 



Diagnostic Programs 



For the ROM-RAM version, replace the last 
group of POKEs with: 

POKEX+21 ,205:P0KEX+22,96:P0KEX+23,0:P0KEX+24,241 : 
P0KEX+25,195:P0KEX+26 ,0:P0KEX+27 ,BD <ENTER> 

For the high RAM version, let X = -20480, and 
replace the last value POKEd (in either 
configuration) with 176. 

These routines will present, just below the 
center of the screen, a pair of characters. The 
first of these is printed in the machine's normal 
configuration (if OUT 254,0 sets your machine to 
normal). The second character is printed with 
the effect of OUT 254,255, which should turn all 
modifications on. Any failure in these routines 
should point to the specific area of breakdown. 
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111 CURES FOR THE COMMON CRASH 

Because TRS-80 computers are sold at 
the 'appliance' level, salespeople and 
users often forget that they are indeed 
computers, prone to all the problems that 
larger computers face. As a user of a 
personal computer, you become your own 
service representative, your own diagnos- 
tician, and your own repair agency. This is 
even more true if you have a custom TRS- 
80. 

This chapter is dedicated to you, the 
user, as service rep, diagnostic engineer, 
and repair person. 

I. SOFTWARE 

Symptoms of software problems: all error 
messages, system lockup and crash, just 
about everything that doesn't snap, crackle 
or pop. 



1. Correct the pro gram - 
cause of crashes. 



the greatest 



By far the largest cause of computer 
'crashes' is the software. Mishandling of 
POKE, PEEK and VARPTR are most 
common as well as improper input/output 
routines, and insufficient error- checking. 



If crashes seem to occur only in specific 
programs, check these for errors before 
turning to hardware cures, although a 
'stuck bit' may always turnup a consistent 
error. 

2. Set memory size correctly for 
machine language or hybrid programs. 

Memory size is a boundary above which 
BASIC is prohibited. BASIC is not 
merely the source program, but consists 
of variable and string storage and the 
BASIC stack. Some of this uses high 
memory, and when memory size is not set 
as specified, these variables and stack 
information can run into the high- memory 
machine language program. 

3. Wait out or re-write long string 
searches and sorts. 

The memory allocation method for strings 
has made 'garbage collection' techniques 
necessary. When sorting is complex and 
the number of strings is large, this process 
can take from a few minutes to an hour, 
during which the computer seems locked 
up. One cure is clearing as much string 
space as possible; when all variables have 
been defined, break and PRINT MEM. 
To the program, add a line such as CLEAR 
MEM-N, where N is about 100 bytes 
more than the difference between the 
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program with all variables defined and 
your total memory; subtract about 20 
bytes from the CLEAR statement for 
each nested FOR-NEXT loop and 
GOSUB. Refer to 'BASIC Faster and 
Better' and other books for techniques of 
rewriting string handling using variable 
pointers, and otherwise using memory 
economically. 

4. Read the manuals. 

Most bugs are called 'features' by 
program authors. Discover these features 
in the program documentation. 

I. POWER 

Problems Caused by Poor Power: system 
reboot, unexpected syntax errors, speckles 
on screen, shrinking screen, unexpected 
disk or Stringy-Floppy startup, total lockup 
of system. 

5. Add a line filter or power supply 
monitor. 

'Clean' power enhances system reliabil- 
ity. The simplest help is a line filter such 
as that sold by Radio Shack. More severe 
power problems can be ameliorated by 
using power supply monitors such as 
Topax or Mayday. Isolating other appli- 
ances (power tools, washers, refrigerators, 
toasters, water pumps, fluorescent lamps, 
etc.) from your computer's outlet will 
enhance reliable operation. You can even 
build some very simple filters yourself: 



20 turns heavy solid 
wire (insulated). 






Line isolation 
transformer 



6. Use 3-wire grounded circuitry for 

all equipment. 

3-wire circuitry is electrically quieter 
and safer. Some equipment, particularly 
printers, have damaged computers when 
used in an ungrounded or improperly- 
grounded environment. If you have an 
older, 2 -wire system, test for floating 
voltages using a neon test light, available 
from hardware stores. Reverse the plugs 
in the socket until all voltages disappear. 

7. Stop strong power drains (granite 
sheds, arc welders). 

Strong power drains are visible as brief 
but distinct shrinking and dimming of the 
video. Cassette and disk I/O problems 
are most likely, but power drains can 
sometimes result in program failure. A 
high quality power supply monitor can 
help. Also, if you don't live in an industrial 
area, your power company or zoning com- 
mission might be able to assist. 

8. Fuse in the power supply might be 
going or gone. 

All separate TRS-80 power supplies 
contain fuses in order to receive an Under- 
writers Laboratories approval. Earlier 
supplies are sealed, but the seal can be 
broken by forcing a screwdriver around 
the joint at the bottom of the supply and 
gradually popping off the top section. 
Later supplies have screws under the 
rubber feet. Fuses are cheap. Don't test 
the fuse, replace it. It will need to be 
resoldered since these fuses are not in 
sockets. 

9. Replace or resolder faulty power 

cables at the connector. 

The power connector is not molded in 
place, and after a year of abuse, the 
soldered connections can break inside. 
Lift the tabs on the plastic sheath and pull 
it back. The connector can be resoldered. 
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If the power remains intermittent, the 
problem may be at the point where a band 
of metal is crimped around the cable. 
Loosen it, cut the cable shorter, and 
resolder. The 5-pin DIN plug is sold by 
Radio Shack if you want to replace it 
completely. 

10. Install a lightning arrestor in 
spite of the phone company. 

If you have a direct-connect modem, 
lighting strikes may be damaging your 
system, or at least affecting its perfor- 
mance. For best protection, always unplug 
the system from the phone and power 
lines when a storm is in the area. You can 
also obtain a Til lightning arrestor from 
Datadyne, 450 Seventh Avenue, NY 10001. 



II. EDGE CONNECTORS 
Symptoms of edge connector problems: 
system reboot, unexpected syntax and line 
number errors, loss of the end of a program 
or text file, system lockup, return to READY 
before program end. 

11. Clean edge connectors by erasing 
them. 

Since the solder-coated edge connectors 
are prone to corrosion, they must be 
cleaned regularly. The simplest methods 
are vigorous rubbing with a piece of 
coarse paper like a dollar bill, or erasing 
with pink pearl (good) or white plastic 
(best) erasers. 

12. Spray edge connectors with 
contact cleaner and swab with cotton. 



Once you have cleaned the edge 
connectors thoroughly, a weekly applica- 
tion of a small amount of spray contact 
cleaner (such as Radio Shack 64-2320), 
followed by rubbing with a cotton swab, 
will keep the contacts in good shape. 



13. Emery-paper edge connectors for 
really bad corrosion. 

For really bad corrosion or scoring from 
continuous insertion and removal of con- 
nectors, the finest grade of emery paper 
or cloth can be used. Use wet-or-dry 
paper soaked in contact cleaner or diluted 
isopropyl alcohol, and rub smoothly along 
the connectors. Follow up with more 
contact cleaner and cotton swabbing. Rub 
just enough to bring up a shine, and do not 
use coarse emery paper. Never sand down 
to the copper traces. 

14. Silver solder the edge connectors 
with Silver-It. 

Corrosion can be reduced to a minimum 
while maintaining the original physical 
size and shape of the edge connectors by 
obtaining a Silver-It kit from Fuller 
Products, Grand Prairie, Texas. This is a 
process that must be completed with 
great care, but will result in connectors 
that (except in chemically violent atmos- 
pheres in major cities) need virtually no 
cleaning. For Radio Shack repairs, this 
process looks like no modifications have 
been made. 

15. Gold plate the edge connectors. 

Most difficult of the solutions is gold 
plating, which is also a poisonous process. 
However, when it is complete, the result 
will be connectors of the original physical 
size with a corrosion-free gold coating. 
Refer to 80 Microcomputing, December 
1981, for full details. 

16. Replace the connectors with gold 
plugs from EAP. 

Easier than silvering or gold plating and 
less annoying than regular cleaning are 
replacement gold edge connectors (Gold 
Plug 80) sold by EAP Products, Box 14, 
Keller, Texas. Because the connectors are 
made by Kel/Am, they do not mate properly 
with AP Products connectors. Peri- 
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pherals using AP connectors can be easily 
changed to use the T&B/Ansley connector 
sold by Radio Shack. Also, the Gold Plug 
80 connectors will protrude from the 
keyboard unit and expansion box some- 
what less than an inch. 

17. Solder all the connectors into one 
box and one board. 

Model III cases can be purchased as 
replacement parts through Radio Shack's 
National Parts distribution system. If you 
wish to have a one-piece system, this can 
also cure the edge connector problem. 
Heavy pieces of copper wire can be 
soldered to the keyboard and expansion 
edge connectors, effectively creating a 
single large board. Don't solder a cable in 
place and then put one board on top of the 
other, because electronic noise will be a 
problem. 




18. Both unbuffered and buffered 
cables are inserted only one way. 

The buffered cable is marked clearly as 
to which end connects to the keyboard 
and which end to the expansion interface. 
However, the unbuffered cable is also 
directional because it contains a shield 
which should be connected to ground. If 
the cable is reversed, the large shield will 
be connected to a system reset signal — a 
sure troublemaker. Examine the cable for 
a fine copper wire sliding out from be- 
tween the grey plastic 'sandwich'. It 
should be on the left side of the cable 
when the cable is attached, with the 
smooth face of the cable toward the top. 



19. Cables not inserted all the way or 
crooked on connector. 

Interconnect cables, particularly AP 
Products connectors, need to be fully 
inserted to make electrical contact. Al- 
though the expansion cable is not usually 
inserted partly or crooked, it is easier to 
do with the printer and disk cables, which 
are somewhat out of sight. Also, Kel/Am 
connectors have a limited life — about 50 
insertions and removals before the con- 
tacts bend inside the connector. Examine 
the end — all contacts should be even. 

20. File carefully to cure a tight fit on 
the edge connector. 

Most Model I TRS-80's contain 
printed circuit board slightly thicker than 
that normally used with edge connectors. 
Although the cable will go on, it has to be 
forced. To avoid this, smooth the very 
edge of the circuit board with a fine file, to 
round the edge. Pile back not more than 
1/8 inch: 




III. MEMORY 

Symptoms of memory problems: erratic 
operation, unexpected syntax, unidentified- 
line, next-without-for and sub script-out- of- 
range errors, incorrectly reported memory 
on power-up, program lock-up. 

21. Replace slow memory with faster 
chips, but check speeds. 

All dynamic memory has a window 
during which data is valid for the CPU. 
Refer to Chapter 4 for a table of memory 
speeds for keyboard unit and expansion 
interface. Also, note that memories can 
deteriorate with age, and poorer access 
time is one of the first signs of age. 
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22. Replace bad memory with good 
memory, using a memory test. 

A memory test will reveal memory chips 
which are genuinely bad, identifying both 
their address and the bit (chip) involved. 
Remember that addresses 4000-7FFF 
are in the keyboard, and the expansion 
interface contains two banks, 8000-BFFF 
and COOO-FFFF. 

23. Replace older memory with newer 
(post-1979) memory. 

Early dynamic memories were plagued 
with the occasional 'soft error — a pro- 
gram crash not caused by any permanent 
hardware affliction. The error was finally 
identified as a slow emission of alpha 
particles from the substrate (base) of the 
memory circuitry inside the chip. These 
particles would strike a memory cell, 
changing it. The occurrence was unpredic- 
table. The best cure for this dilemma is 
the replacement of all such memories. 
Date codes are stamped on the chip in 
year/week format, such as 7851 (end of 
December 1978); use memories with an 
8001 or later date code. 

24. Increase access with a modifi- 
cation to Z69. 

If the problem seems to be slow or aging 
memory, the Z69 modification can help. 
Cut trace from Z69 pin 5. Attach Z69 pin 
12 either to Z69 pin 10 or to Z69 pin 13. 

25. Install a buffered cable according 
to modified Radio Shack instructions. 



When memory failure seems to occur as 
more items are added to the system via 
the expansion interface, then (in earlier 
units) a buffered cable is called for. It 
provides additional fan-out (drive) capa- 
bilities to the keyboard unit. This item is 
available from Radio Shack at no charge 



to owners of early expansion interfaces. 
You can identify the earlier interfaces 
because the 32K memory runs from back 
to front; in newer boxes it runs along the 
back. Refer to Chapter 4 for installation 
instructions. 

26. Install the twisted-pair DIN plug 
modification. 

In addition to the buffered cable, some 
earlier interfaces may require the 'twisted 
pair' modification. This is a 6-wire DIN 
cable combination to carry memory select 
signals RAS, CAS and MUX. Refer to 
Chapter 4 for installation instructions. 

27. Modify twisted pair resistors 
upward to 470/680 ohm pairs. 

If the installation of the twisted pair mod 
deteriorates rather than ameliorates oper- 
ation, change the resistor values specified 
by Radio Shack to 470 ohms to ground, 
and 680 ohms to 5 volts. Both are 
originally 220 ohms. 



28. Straighten bent pins under 
socketed ICs. 

Memory chips and the CPU were the 
only chips socketed in earlier machines. 
However, various runs of the computer 
had the character generator, line buffers, 
and so forth, in sockets. Evidence of bent 
pins is a machine which acts up when 
given a light physical shock — such as 
hard typing. Lift each IC and check for 
bent pins; be sure not to bend any pins 
when putting it back! If your machine has 
had a recent trip to salt-water environ- 
ments, the problem will be more severe; 
see #104. 

IV. FIRMWARE 

Symptoms of firmware problems: incor- 
rectly read data, equality failures in IF- 
THEN statements. 
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29. POKE 16553, 255 to correct 
BEAD/DATA error. 

In Version 1 of the Level II ROM, under 
certain conditions the same data would be 
read over and over, with the data pointer 
not being stepped through memory. The 
most common fix is POKE 16553,255 
added as the first line of any program. 
Also, any INPUT statement before the 
reading of data begins will take care of 
properly stepping the pointer. 

30. There are floating point accuracy 
errors, such as X-YO X-Y%. 

Because of the way real numbers are 
handled digitally, there is a very small 
numeric residue left after some types of 
calculations. Where IF-THEN state- 
ments don't seem to work when you know 
they should, break into the program and 
print the offending variables. Chances are 
you will see that a value, instead of being 
20 as you expected, is actually 20.00001 
as a result of residual binary information. 
Use integers where you can for such tests; 
see the Level II manual for details. 

V. RS-232 

Symptoms of RS-232 problems: incor- 
rectly received or transmitted characters, 
system crashing or lockup when not using 
RS-232, electronic failure. 

31. Place bar across RS-232 to keep it 
in place. 

Heat buildup and general stress in the 
expansion box will cause a warping of the 
RS-232 board, lifting some contacts 
above the connection pins, or making the 
unit vibration sensitive. By using longer 
mounting screws and a heavy insulated 
metal bar, the warp can be prevented. 
You may have one made at a local metal 
shop, then cover it with 'heat-shrink' 
tubing sold by Radio Shack. Recently, 
some sources have been making such bars 
available; look for ads. 



32. Clean RS-232 contacts vigorously 

with cotton cloth. 

These contacts too are solder-plated, 
and prone to corrosion. But they are also 
very thin, and only a clean cotton cloth - 
together with vigorous rubbing (and per- 
haps a little contact cleaner) should be 
used. Make the contacts shiny. 

33. Reseat the RS232 board, checking 
for bent pins. 

The RS-232 board contacts are 1/20 
inch from center to center, exactly half the 
size of the edge connectors. Bent pins on 
the expansion interface RS-232 connector 
can cause shorts which will affect not only 
the operation of the RS-232 system, but 
the computer as a whole. Reseat the 
board, checking under strong light that all 
the connecting pins are straight and con- 
tact properly. 

34. COM/TERM on RS-232 must be 

in correct position. 

Recheck the RS-232 manual, and make 
sure that the Communications/Terminal 
switch is in the correct position for the 
software you are using. 

VI. DISK 

Symptoms of disk problems: lost data, 
hang-up during disk access, rattling and 
banging of disk mechanism. 

35. Use better disks, the best you can 
get if data is critical. 

If you've spent an hour entering data, 
you've paid for the best diskette you can 
buy. Purchasing cheap disks is false 
economy. 

36. Install a data separator, doubler, 

or other separation. 

Data is stored on disk as a continuous 
stream of clock pulses separating data 
pulses. As a matter of economy, Radio 
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Shack chose to use 'internal' separation 
— that is, using the disc controller inte- 
grated circuit to distinguish between clock 
and data pulses. The disc controller's 
manufacturer does not recommend this 
method; therefore, a piggyback data 
separator (sold by several sources) rein- 
states the proper electronic design. 
Similarly, a double- density controller con- 
tains the essential data separation. If you 
obtain a 1771B-01 data sheet from 
Western Digital Corporation, you can 
build your own data separator. 

37. Align the disk drive read/ write 
head professionally. 

When a single- drive system is in use, 
misalignment of a drive head might not be 
noticed. However, in a multi- drive system, 
one drive may produce an unusual number 
of re-seeks or error messages. If you 
suspect misalignment of the head, don't 
attempt to service it yourself. You can 
obtain an alignment diskette (a good one 
is manufactured by Dysan) to confirm 
your suspicions, but professional service 
is called for in this case. 

38. Clean the disk drive read/write 
head with cleaning disks. 

When a large number of disks are in use, 
especially inexpensive ones, tiny bits of 
oxide are shed onto the drive read/write 
head. Since this is not immediately 
visible, it's good practice to obtain a disk 
cleaning kit (Scotch and others) and use it 
weekly. 

39. Erase-clean connections to the 
disk drive. 

The edge connector to the disk drive is 
afflicted with the same corrosion problem 
as other edge connectors. The solutions 
are the same: cleaning, plating, and 
replacement with gold plugs. See under 
edge connectors (#11 above) for more 
information. 



40. Replace 74LS38/LS16 c 
lector ICs and socket them. 

The cable to disk drives is long and must 
be driven by higher- current integrated 
circuits, type 74LS38 (74LS16 in the 
newer expansion box). These can often 
break down under continuous use and in 
situations where the drives are often plug- 
ged in incorrectly. The most evident 
symptom is failure during formatting or 
backup, because the stepping signal (low 
to move outward, high to move inward) 
deteriorates and missteps the read/write 
head. Remove these chips, and solder in 
sockets. Then keep a small stock handy 
so they can be replaced when these symp- 
toms show up. 

41. Lubricate disk drive and rails 
sparingly with silicones. 

Many disk drives squeal and clatter. 
There is no need to risk mechanical 
failure. Remove the cover and lubricate 
the motor bearings and the guide rails; 
use only a very light grade silicone lubri- 
cant, and wipe any extra lubricant off once 
it has spread across the area that needs it. 
Refer to Exclusive Oracle, 80 Micro- 
computing, January 1982, for details. 

42. Keep the disk door closed till it 
stops to protect loaded heads. 

Your disk drive may contain 'loaded' 
heads, which means that the door 
mechanics do not lift the head away from 
the disk when the door is opened. If you 
remove or insert a disk before the select 
light goes out, you may damage the head 
assembly. You can tell if your drive has 
loaded heads from the documentation, or 
by listening for a 'clack' when the drive is - 
selected, and a second 'clack' when the 
select light goes out. In any case, it is good 
practice to leave the disk in place in any 
drive while the motor is spinning. 
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43. Put disks in correct keyed cable 
position. 

Disk drive selection (drive to 3) can be 
made in two ways: the drive itself may be 
programmed with internal jumpers, or the 
cable may have teeth pulled to eliminate 
the unwanted select signals. If your drive 
programming and missing teeth do not 
match, then the drive will appear dead 
when selection is attempted. Make sure 
your drives are marked 0, 1, 2 and 3, and 
that you match them correctly to the 
cable. 

44. Disk cable must be right side up. 

If your disk drive keeps running and 
doesn't otherwise work, the drive is prob- 
ably plugged into the cable upside down. 
Try reversing the connection. Since many 
drives have cables protruding out the 
back, and the physical position of these 
cables is not standard, the plug-in may 
look correct with respect to the other 
drives, but be backwards. 

45. Disk cable must be fully installed 
inside case. 

The cable protruding from the back of 
some brands of disk drives is usually not 
hard-wired, but simply an extension cable 
from an internal edge card. Under the 
weight of the long multi- drive cable, or 
simply from regular moving and unplug- 
ging, this internal connector can come 
loose, resulting in erratic operation. 
Remove the case top and re-insert the 
extension cable. A piece of strong plastic 
packing tape can keep this cable from 
shifting. 

46. Insert the disk correctly into the 
drive. 

This is not as obvious as it seems. If you 
mix different brand drives on your system, 
you may discover some in which the disk 
must be inserted with the write-protect 
notch pointing down rather than up. 



Usually the write-protect notch points 
toward the side of the drive where the 
select light is mounted, but even that is 
not standard. Be especially careful about 
this when using an unfamiliar system, as a 
hangup during disk access can be fatal to 
data in memory. 



47. Remove or pad sources of vibra- 
tion nearby disks. 

If you have lived or worked in an area for 
some time, you have probably blocked out 
sources of vibration, such as heavy equip- 
ment, trains, etc. However, this kind of 
vibration can ruin a disk write or read. 
The simplest solution is padding: a layer 
of heavy cloth, a layer of cork, a layer of 
wood or metal. If you have occasional 
inexplicable read/write errors, tune your 
senses to the environment. 



48. Update the DOS, especially if it's 
an early version of TRSDOS. 

Most of the bugs and inconveniences of 
early versions of TRSDOS have been 
corrected either by Radio Shack, or by 
other software houses who have created 
new disk operating systems. To avoid 
frustrating errors, update your DOS. 

49. Keep disks clean, unbent, and 
store them straight up in cases. 

Though this may seem obvious, there are 
hidden causes of dirt: smoking, heavy 
dust or other airborne particles, air 
freshener sprays, animals, etc. Bending 
can be caused by storing disks sideways, 
keeping them in a car window, or inserting 
them hastily into the drive. Don't drink 
soda nearby — unless you put your disks 
right back in their sleeves (which you 
should do); the bursting bubbles of car- 
bonation can carry sugar residue to the 
disk surface, damaging the recorded data 
and abrading the disk head. 
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VII. TAPE 

Symptoms of tape problems: loading impos- 
sible, hangup during load, tape won't go on 
or off, tape won't record. 

50. Align the tape recorder head by 
drilling a hole. 

Misalignment is singly the largest tape 
problem. Put the recorder in playback 
mode with no cassette in place, and shine 
a bright light so you can see the Phillips 
alignment screw to the left of the tape 
head. Drill a hole directly above it. Align 
the head by popping in a good commercial 
music tape, and turning the screw until 
the sound is at is brightest. Use this for 
standard recording and playback, but 
readjust for any commercial tapes that 
don't sound 'bright'. 

51. Clean the tape recorder head with 
isopropyl alcohol only. 

An oxide buildup is common on all tape 
recorders. Using head cleaner or iso- 
propyl alcohol (not acetone!), swab the 
tape head and other metal parts which 
exhibit brown oxide caking. This will 
prevent scratching or scraping of the tape 
surface, as well as ensure good contact 
with the tape head. 

52. Demagnetize the tape recorder 
head with proper devices. 

The high frequencies are the most 
crucial element in good tape loading, and 
a magnetized tape head erases some of - 
these high frequencies every time the 
tape is played. Pick up a cassette tape 
head demagnetizer, either a plug-in type 
or the kind packaged in a cassette case, 
and demagnetize the cassette player at 
least monthly. 

53. Use better tape but not the very 
best audio stuff. 

Good tape will always give good loads. 
Avoid inexpensive tapes like Certron, 
Concertape, and questionable depart- 



ment store house brands. Radio Shack 
red-label Realistic tape is just fine, as is 
most any good audio tape. Very high 
quality tapes (chromium dioxide, metal, 
etc.) are not necessary, except for archival 
backups. Digital tapes from Microsette 
are only about $.65 and are sold in handy 
lengths (C-10 and C-20). 

54. Modify the CTR-80 with a diode to 
prevent head glitches. 

If the stop button was pressed during 
loading, a head field collapse in early 
CTR-80 tape recorders would put glitches 
on program tapes. Radio Shack provides 
a free modification for this problem. If 
you wish to do it yourself, a small silicon 
diode (such as type 1N4148) can be 
connected across the tape head contacts. 

55. Replace cassette relay to prevent 
sticking. 

The current drain of the CTR-41 tape 
recorder, and many non-Radio Shack 
recorders, is too high for the relay contacts 
in the keyboard unit. This causes it to 
stick closed, keeping the tape recorder 
running when it should not. There are two 
options: change tape recorders, or change 
relays. The relay change is permanent, 
and a new unit can be obtained from Lab 
Service, Inc., in Hustisford, WI. 

56. Use CTR-80 to prevent cassette 
relay burnout. 

If you don't want the trouble of replacing 
a relay, use a CTR-80 tape recorder. It 
also prevents wear and tear on the cables, 
because rewind and fast-forward can be 
used without pulling the motor-control 
plug. 

57. Clean the capstan and pinch 
roller with isopropyl alcohol. 

As the tape recorder sees a lot of use, two 
things will happen to the rubber pinch 
roller: oxide buildup and glazing. Oxide 
buildup is similar to that on the tape head, 
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but on the roller it can cause tape to slip 
out of place, creasing it. Glazing is a 
shininess of the rubber surface, also caus- 
g tape slip and speed variations. Both can 
be cured with the liberal application of 
isopropyl alcohol, acetone, or tape roller 
cleaner. Hard-glazed rollers need to be 
brought down with fine emery paper. 
58. Add a switch box to the cable 
assembly for hand operation and 
sound. 

A very useful addition to your tape 
system is a small switch box containing a 
speaker; headphone speakers are best. 
With a simple two-switch box you can 
listen to programs being saved, keep the 
motor running, and stop it when you wish: 



output cables. Pull back the plastic 
sheath on the computer end of the cassette 
cable, and cut either one — but not both 
— of the two shields going to ground (pin 
2, the center pin). This will kill ground 
loop hum. 

61. Replace or resolder a faulty cas- 
sette cable at the connector. 

If you often pull the cassette cables out 
of the recorder, you may break the internal 
wiring. This will be evident as a crackling 
sound during program saves, or partial 
good loads from tapes which once loaded 
perfectly. You can replace the connectors 
with mini and submini plugs, or you can 
obtain a complete new cable. 





\ 

59. Get the XRX-II cassette modifi- 
cation. 

Radio Shack created a special cassette 
system modification, which is available at 
no charge. It improves 500-baud loading, 
but consists of a 500-baud window — 
which means using cassettes running at 
any other baud rate (hardware or software 
based) is impossible. However, the modi- 
fication can be switched out if you wish to 
have the advantages of good 500-baud 
loading and not lose the option of other 
speeds: 

60. Ground loop hum in cassette 
system is cured by breaking the loop. 

Some loading problems can be attributed 
to hum during program saves. This is due 
to a 'ground loop' created by the input and 



62. Replace the dual cassette relay or 
driver IC. 

If the dual- cassette system from the 
expansion interface ceases to function, 
either the relay or its associated driver 
integrated circuit (Z41) may be bad. You 
can test the operation with: 



1 A=1 4308 :P0KEA,0:F0RX=1T09: NEXT 
:P0KEA,1 ;F0RX=1T09:NEXT:G0T01 



The relay in the expansion box should 
clack rapidly. 

63. Cassette cables must go to correct 

expansion box positions. 

If one cassette seems to load and the 
other doesn't, then check that the cas- 
sette cables are properly installed. The 
order (looking from the back) is not parti- 
cularly logical: Common Cable, Cassette 
#1, Cassette #0. 



VIII. HARDWARE 
Symptoms of hardware problems: loss of 
power, changing of memory contents, key- 
board lockup, no apparent expansion inter- 
face memory, miscellaneous woes. 
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64. Tighten the power transistor 
screw and resolder screw head. 

The keyboard unit's power transistor 
(Q2) was screwed into place, with the 
screw acting as an electrical connection. 
This screw can corrode, resulting in erratic 
operation and frequent complete system 
crashes. Remove, clean and tighten this 
screw. 

65. Terminate data lines either up or 
down, but only once. 

The eight data lines are flying free in the 
TRS-80 system. For reliable operation, 
they should be terminated with resistors 
— but only once. Since some peripherals 
contain terminating resistors, the best 
idea is to obtain an edge connector, and 
solder resistors to it. Eight resistors (680 
ohms, 1/4 watt) go from data lines to 
ground, eight resistors (470 ohms, 1/4 
watt) go from data lines to 5 volts. 

66. Add two capacitors to RAM bank 
the expansion interface. 

The absence of two capacitors from the 
expansion interface has never been ex- 
plained. There was a place for them, and 
their inclusion improves operation. Install 
two electrolytic capacitors (10 mF, 16V) 
in the positions marked C54 and C55 in 
the two rows of memory in the expansion 
interface. 

67. Replace the CPU with a Z80A for 
high speed, or a Z80B for best 
operation. 

If you are running your computer at high 
speed (100% increase or greater), you are 
exceeding the formal specifications for 
the Z80 processor. Although many Z80s 
can run at that higher speed, certain 
complex operations (stack operations, for 
example) can fail. Replacing the chip with 
a Z80A (4MHz version) or Z80B (6MHz 
version) will enhance reliability. 



68. Replace memory for high speed, 
but observe DDU wiring changes. 

Replacing expansion interface memory 
for high speed operation may not always 
help run the machine reliably.' Newer 
expansion boxes contain a digital delay 
unit for memory selection, which has a 
fixed access time. Refer to Chapter 4 for 
wiring changes to the DDU for high speed. 

69. Check power supply voltages 
with a calibrated meter. 

Since the miniature voltage adjustment 
controls were not lacquered, vibration can 
cause them to move, resulting in the 
voltages being out of calibration. Units 
showing as little as 3.2 volts on the 5-volt 
line have been seen. Obtain a calibrated 
meter (not a $10 off-the-shelf number) 
and adjust the voltages — 12 volts first, 
then 5 volts. These are R10 (12 volts) and 
R5 (5 volts) in the keyboard unit. 

70. Increase C48 in the expansion 
interface to keep the disk going. 

A discouraging aspect of some disk 
operating systems is that they cannot 
recover from a disk drive which has 'timed 
out' — the motor has stopped. Some 
DOSes contain a Shift/Break option, but 
this does not always function, depending 
on when the disk timed out. A better 
solution is to increase the value of C48 
(C62 in the newer expansion box) from 33 

mF to 47 mF or 68 mF. Use a bead 
tantalum capacitor, not an aluminum 
electrolytic, if possible. 

71. Add or remove disk termination 
resistors. 

In order for disk selection to take place 
properly, termination resistors are re- 
quired. Normally, these should only be 
installed in the furthest drive on the cable. 
However, as people trade or sell units, or 
purchase them from a variety of manufac- 
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turers, the number of termination resistors 
may vary. These can be found by remov- 
ing the disk drive cover; they are a red, 
white or blue integrated-circuit sized 
package, usually near the edge connector. 
Make sure only one set of resistors is in 
place, no matter how many drives are in 
the system. 

72. Make the reset modification to 
the expansion interface. 

It seems the option to turn off a disk 
system should have been provided with 
the expansion interface. Ironically, other 
manufacturers have followed the original 
unresettable design. You can get out of 
many program hangups by pressing reset 
in a Level II keyboard only — so why not 
with an expansion box attached? Refer to 
Chapter 4 for details. 

73. Change LNW termination resis- 
tors to 470/680 pairs. 

LNW expansion systems have placed 
very low termination resistor values in 
their boards. If too many peripherals (or 
any peripherals with their own termin- 
ation) are added to the system, computer 
lockup will probably occur. For reliability, 
these values should be changed to 680 
ohms to ground, and 470 ohms to 5 volts. 

74. Check the DDU in the newer 
expansion interface. 

Sudden failure of memory in new 
expansion interfaces can almost always 
be traced to failure in the digital delay unit 
(DDU), marked Z37. This unit should be 
slightly warm — neither hot nor cold — to 
the touch. Since replacement DDUs are 
about $20, get some help if you're not sure 
whether the DDU is bad. 

75. Make sure the ROM cable is okay, 
neither pulled from its sockets, nor 
with bent pins. 

If the computer crashes with an occasional 
screenful of garbage, or patterns of@ 9@ 9, 



@ A@ A, etc., or it fills the screen from the 
bottom left with AAA, then suspect a 
flukey Level II ROM cable, or a cracked 
DIP shunt (see #7 below). Make sure the 
cable is fully installed. No pins should be 
bent or broken on the cable; replace it 
with another 24-pin jumper cable if any 
pins are bent or broken. (If they're bent, 

chances are they'll be broken when you 

try to bend them back). 

76. Cold solder joints, splashes, balls, 
etc., can be anywhere. 

This is the worst problem. TRS-80 
computer boards are soldered mechani- 
cally, and residual solder bits are cleaned 
away. However, a few balls, splashes or 
hairs of solder may remain, breaking loose 
after the vibration of a year of use to cause 
trouble. Remove all cables and shake out 
the computer; small solder bits may drop 
out of the case. Also, broken traces can 
occur, particularly where any scratches in 
the green solder mask have occurred. 
This might be a 'professional help' category. 

77. Check DIP shunts for correct or 
accidental breaks. 

Another cause of @9@9, @A@A, 
@S@S, or the moving A A A A are DIP 
shunts. Only certain pins (see Chapter 4) 
should be broken in the DIP shunts (Z3 
and Z72 in the keyboard unit). DIP shunts 
may have hairline cracks; remove them 
and check with an ohmmeter to be sure. 
You can replace DIP shunts with DIP 
switches or ordinary staples. 

78. Reset problems are a bad CPU 
and related capacitor, no disk system 
in use, or are program-caused. 

Users who recently install an expansion 
interface often forget that the reset button 
no longer works as it used to, and this is 
particularly a problem if no disk drives are 
attached (see #72 above). However, 
there are three other reasons for reset 
failure, even if disks are in place: the reset 
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pin of the Z80 CPU is bad (meaning 
replace it), or the associated charging 
capacitor and bleeder resistor (R47 and 
C42) are bad (replace them), or the pro- 
gram attempts to use the machine lan- 
guage HALT intruction (see Chapter 3). 

IX. KEYBOARD 

Symptoms of keyboard problems: key- 
bounce, keys not working, multiple dif- 
ferent characters, continuous scrolling ?SN 
or ?S errors on screen, constant repeating 
memory size question followed by odd 
characters. 

79. Clean keyboard contacts — old 

one only — not ALPS. 

The most straightforward cure for 
keybounce is cleaning the keyboard. On 
the bounce-prone keyboards (see photos 
in Chapter 4), the keycaps lift off. The 
keys can be cleaned with dry air, spray 
cleaner (works well but requires cleaning 
more often), or filled with silicone grease 
(some people say this improves the feel of 
the keyboard). The latter technique re- 
duces bounce from vibration as well. 

80. Use KBFIX and other software 

instead of a new keyboard. 

A debounce program — automatic on 
most disk systems — can be loaded at the 
beginning of each session. Radio Shack's 
KBFIX is clumsy to get loaded, but 
works. The debounce routine presented 
in Chapter 3 works well. Note that new 
ROMs ('R/S L2 BASIC) contain a de- 
bounce routine, and a second routine 
added to this can result in very slow key 
response. 

81. Get ALPS keyboard, which is the 
debounced keyboard. 

If you can afford the $75 replacement 
cost, a Radio Shack Hall-effect ('ALPS') 
keyboard will permanently take care of 
bounce problems. If you switch often 
between BASIC and machine language 



programs, play games, or have a variety of 
disk operating systems or text editing 
programs, the ALPS keyboard may be the 
best solution. 

82. Replace 74LS05s in the keyboard 
if multiple or unusual characters 
appear. 

If multiple or unusual combinations of 
characters appear unexpectedly on the 
screen, or if characters begin to repeat by 
themselves, then the 74LS05s on the 
keyboard baseplate are probably bad. 
Replace them both, in sockets. 

83. Replace or repair the keyboard 
cable if odd stuff shows up. 

Another cause of odd character com- 
binations — usually this like 'FIAQ9' or 
some such when a single or pair of letters 
is pressed — is a cracked or intermittent 
keyboard cable. Replace it; see Chapter 
10. 

X. VIDEO 

Symptoms of video problems: no video, 
dim video, screen tearing or twitching, 
blurred screen, screen glitches. 

84. Add a buffer stage or resistor to 
cure video tear. 

Lowering the value of R14 in the video 
monitor will reduce the 'tearing' present 
when large blocks of graphics are dis- 
played, especially using reverse video. 
See Chapter 4 for details. The other 
option is to obtain a video buffer circuit 
from Archbold Electronics. 

85. Add a deglitch modification for a 
prettier screen. 

The video 'hash' created when graphics 
are being drawn is caused by a conflict 
between the relatively independent video 
display circuitry and the need of the CPU 
to access video memory. Add the deglitch 
modification for a clearer screen, pre- 
sented in 80 Microcomputing, Feb. 1982. 
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86. Get a new character generator, 
with descenders. 

Upper case characters on the TRS-80 
have always been consistent, but lower 
case characters can be displayed either 
with flying letters (g, p, q and y) or with 
descenders. The presence ofa 'flying a' is 
normal on early computers. The new 
character generator with descenders can 
be obtained as a 'word processing char- 
acter generator' from Radio Shack. 

87. Horizontal and vertical image 
adjustment can be done. 

If the image is not centered on the screen 
(use 

10 F0RX=15360T016383;P0KEX f 191 sNEXT 
20 G0T020 

as a test program), adjust variable resistors 
R20 and R21 in the keyboard unit. 

88. Adjust horizontal and vertical 
sync on the monitor. 

If the image flickers badly, tears 
sideways, or rolls, the video monitor may 
be out of adjustment. Turn the white 
horizontal and vertical adjustment con- 
trols on the back of the monitor, just as 
with an ordinary television that exhibits 
the same symptoms. 

89. Add a capacitor to cure video 
twitch. 

A continuous, annoying screen twitch is 
the result of oscillations present at the 
video output. The insertion of a small 
capacitor (47 to 220 pF) between Z50 pin 
3 and ground will eliminate the twitch. 

90. Dimmers off! Get rid of the little 
runners on screen. 

Similar to a twitch is the 'runner', a 
shaking horizontal line that works its way 
up or down through the screen, rocking 
one line of letters back and forth. This is a 



kind of reverse RFI — not caused by the 
computer for a change — which can be 
cured by turning off light dimmers, faulty 
fluorescent or neon lights, or similar inter- 
ference producers. If you live in an apart- 
ment building, neighboring dimmers 
should not (but may) affect your computer. 

91. Adjust the monitor for blurred 
characters. 

There is no high- voltage adjustment for 
blurred characters; however, there are a 
few kludges. First, a higher line voltage (a 
full 120 volts) will increase the sharpness. 
Adjusting the internal vertical height con- 
trol may reduce the image to the more in- 
focus (center) area of the screen. 
Also, replacing the power transistor on 
the bottom of the chassis and the high- 
voltage rectifier (they both may exhibit 
undesirable characteristics) can improve 
the image. Unfortunately, the monitor is a 
very basic video display, and has few 
adjustments. 

92. Correct the lowercase software 
for LDOS. 

The 'universal' (alas, a dangerous word) 
lowercase modification presented in this 
book is not universal at bootup for one 
disk operating system — LDOS. How- 
ever, the LDOS driver can be invoked 
separately and will work; refer to the 
documentation. 

93. Check the 5 volts or the opto- 
isolator in the monitor. 

A hardly existent or dim picture can be 
caused by insufficient 5 volts into the 
video cable from the computer (check for 
a bad connection), or a weak or dying 
optical isolator on the plug- in card inside 
the video monitor. First, try another 
monitor. If the system works with that 
monitor, resolder the cable connection if 
necessary; if that does not work, replace 
the optical isolator. 
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XI. RFI 

Symptoms of RFI (Radio Frequency Inter- 
ference): herringbone across television 
screens, complete loss of TV stations, whist- 
ling on radio (AMorFM), disconnection of 
wireless telephones, blockout of shortwave 
transmissions. 

94. Shield the entire system for RFI. 

The TRS-80 system is a broad-band 
interference generator; that is, what it 
sends out affects all bands of radio and 
television reception. The interference 
can be lowered by shielding: spray the 
inside of the case with aluminum paint 
and hook that to signal ground; use 
shielded multi-conductor cable for all 
peripherals (it's expensive); and create a 
'Faraday cage' — if your decor will allow it 
— by shielding the room in which the 
computer is used with fine mesh. 

XII. HEAT 

Symptoms of heat problems: loss or lockup 
of program consistently after the machine 
has been on several hours. 

95. Ventilate case or add fan, latter if 
it's an all-in-one system. 

Normal ventilation using the slots cut 
into the TRS-80 and expansion box is 
adequate. However, if speed modifi- 
cations, internal memory additions, etc., 
have been made, the power supply is 
asked to do extra work. A hard desk with 
good circulation around the computer is 
essential, and a small' Sprite' type fan can 
be used occasionally to cool the system. A 
quiet fan may be added for continuous 
use, and is a necessity for an all-in-one- 
case system. 

96. Remove power supplies from the 
expansion interface. 

The two power supplies in the expansion 
interface generate a great deal of heat. 
With the video monitor stacked above, 



this can create an undesirably hot environ- 
ment for memory. Remove the two sup- 
plies from the expansion box; the system 
won't look as compact, but it will have a 
longer life. 



XIII. PRINTER 

Symptoms of printer problems: will not 
backspace or underline, will not move up a 
line at a time during program listings. 

97. Printer may need a line feed with 
every carriage return. 

Many printers require not only a carriage 
return, but a line feed as well; examples 
are Teletypes and some Centronics 
printers. If you have this problem, first 
check with the manufacturer for a modifi- 
cation kit or instructions. If none is 
available, use a disk operating system 
with a CR/LF option, a printer driver 
patch, or a text- editing system with the 
CR/LF option. A hardware addition can 
be made to most printer interfaces to 
generate a linefeed when a carriage return 
is received. 

XIV. USER PROCEDURE 

98. Hide furry animals, keep away 
from wood stoves, etc. 

Insignificant as it may seem, smoke is a 
severe abrasive to disks. Smoking, wood 
stoves, unskilled kitchen use (ahem), 
animal hair, and so forth, can result in 
airborne particles that affect disks, whose 
rotation acts as a static vortex to pull in 
those particles. Similar cautions apply to 
the piles of hair and grit that can gather in 
the keyboard. If you wonder just how 
much dirt is in the air, open the video 
monitor (with the power off, of course), 
and have a look. All around the high 
voltage will be piles of grit pulled in 
because of the electrical attraction. 
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99. Don't pull the cables while you're 
using the system. 

This might seem obvious, but realize 
that pressing the reset button jostles the 
cable, just as does moving the keyboard to 
make it comfortable. Dropping a pencil, a 
cassette, or a diskette case on the cable 
may generate noise; see Chapter 7 for 
vibration protection. 

100. Wait before power-up after 
power-down to protect memory. 

When the manual cautions to wait ten 
seconds before repowering the system, it 
is not merely because the system doesn't 
always fully reset during that time, but 
also because the application of power to 
the memory must be done in this order: -5 
volts, 5 volts, 12 volts. The -5 volt line can 
be lost with too hasty repowering of the 
system, and memory will be physically 
damaged. 

101. Neither steel wool, nor metal 
filings, nor metal bits should be nearby. 

Using the computer in a home 'shop' is 
dangerous. Wood bits may cause key- 
bounce and disk damage, but metal filings 
may cause the entire system to fail. A 
buildup of metal dust will decrease local 
resistance levels to short-circuits, or create 
unexpected current drains and intermit- 
tent operation. 

102. No water or drinks nearby or 
open windows. 

Drinking cups can damage disks, water 
glasses can fall over, carbonated soda can 
bubble tiny sugar globs onto tapes and 
disks, and open windows can invite water- 
carrying breezes and even rainstorms. 

103. No magnets nearby, especially 
unobtrustive refrigerator types. 

Refrigerator or bulletin board magnets 
are handy things, but because they are so 



ubiquitous, their danger to magnetic media 
is easy to forget. If there are any in the 
house, keep track of them . . . magnets 
shaped like daisies or fruits, bars, mag- 
netic kiddie letters, even magnetic screw- 
drivers and scissors. 

104. Watch out for salt air areas. 

There's nothing like salt air for corroding 
metal, and metal is the heart of the 
computer's interconnections. Integrated 
circuit pins can corrode, cables can corrode, 
even screw connections can corrode. In 
boards previously reliable, salt air can 
corrode unseen bent pins, making the 
system flakey. 

105. Keep telephone bells away, which 
are bulk erasers. 

More than 50 volts shoot into a 
telephone bell's electromagnet. It's a 
strong magnetic field, and can act as a 
bulk eraser for disks sitting under them. 
Keep phones 'way back on the desk. 

106. Keep out of Xray at airports; 

hand check disks and tape. 

Xrays are damaging to magnetic mat- 
erials. When going through an airport 
check, keep all your disks and tapes under 
your arm. Don't check them with your 
luggage, and don't let them go through the 
carry-on luggage conveyor belt Xray device. 
Insist on a hand check for those items. 

107. Attach cables correctly. 

Make sure all cables are correctly in 
place. Mark disk cables (the worst culprit) 
with 0, 1, 2 and 3, as well as 'top' and 
'bottom'. Mark the expansion cable the 
same way (the metal wire or blue stripe is 
to the left, smooth side up). Mark all 
peripherals, particularly those which re- 
quire power from the expansion box. 
Also, be sure the cassette cables are 
incorrectly (see #63 above). 
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Chapter 11 



Last Thoughts 



108. Attach cables with power off, no 

matter who says what. 

Occasionally, a manual may say some- 
thing about turning the computer on, then 
attaching the cables. This is dead wrong. 
Correctly designed peripherals are always 
connected with the power off. If it is a 
construction project, avoid it; there's 
something wrong with the author's judg- 
ment. If it is a commercial product, return 
it; it shows poor design sense. 

109. Disconnect power especially 

during summer. 

High transient voltages can be present 
over the power and telephone lines during 
electrical storms. If your area is prone to 
electrical storms, keep your system un- 
plugged — not just turned off. Also, 
disconnect direct- connect modems which 
can carry high voltages straight through to 
the rest of the system. 

110. Obtain a static-free mat for 
computer and peripherals. 

In dry climates, static buildup is 
common. A static zap can: change 
memory contents; damage memory; glitch 
a disk or cassette write; glitch a load; 
crash a program; reboot the system; or 
simulate just about any crash your system 
might be sensitive to. Obtain a static- free 
mat, or line your table with aluminum foil, 
and discharge to it — don't touch your 
computer first. 

111. Keep temperature 55 to 80 
degrees, relative humidity 50 to 80 
percent. 

This is simply good practice; although 
my computer is used in 40 degrees or 
below, disk reliability is lessened. Dry 
weather (low humidity) encourages static 
(see #110), and wet weather encourages 
corrosion (see #104). 

112. Test homebrew devices before 

installation. 

There is very little more to say; always 



'proofread' your circuit with a second 
person, no matter how exhausting it may 
seem. It will prolong the life of your 
computer, and the homebrew device might 
even work the first time. 
What are the chances that your problem 
will be one of these? Probably, the 
difficulty will be a combination. This list 
is derived from work on hundreds of TRS- 
80 system combinations and relatives. 
Virtually every suggestion has been made 
and every cure implemented. Sometimes 
the problems were multiple: one unit 
suffered from salt air, bent pins, corroded 
connectors, unbuffered cables, slow 
memory, and a bum program. Another was 
the victim of modifications made with a 
Boy Scout woodburning kit instead of a 
soldering iron. 

Even if your problem is not included 
here,these suggestions should give you a 
clue about where and how to begin looking. 
Use the Radio Shack technical manual 
diagnostic chart — but don't believe the 
'ROM is bad' section, because I've never 
seen a bad ROM. Instead, suspect a bus 
driver difficulty (Z22, 38, 39, 55, 75 and 
76 in the keyboard). Otherwise, the 
manual will give you a good start on the 
tough stuff. 

Last Thoughts 

The solons at Radio Shack have done 
something very impressive: they have 
created a popular personal computer. 
From it have come the Models II and HI, 
the Pocket Computers I and II, the Color 
Computers, the Model 16 is on the way, 
and a host of engineers across the world 
have been encouraged to come up with 
TRS-80 compatible hardware and soft- 
ware, and even full computer improve- 
ments like the LNW-80. 

But they have done something unwit- 
tingly even more special: they have, 
through strict and strange corporate 
policies, challenge users to create the 
Custom TRS-80. Because computers 
become appliances more and more each 
day, there will only be one Custom TRS- 
80 .. . the humble Model I. 



The Custom TRS-80 
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* indicates discussion of topic 

# indicates a program listing 

$ indicates a schematic diagram 



abbreviations *17-18 
AC 97,163-164 
access, sequential 203 
access time 87,222,245 
accumulator 38 
accuracy, floating point 246 
A/D — see analog-to-digital 
address 23,24,40,42 

— absolute 135 

— bus 24,199-201 
addresses 

— 0050 lookup table 55 

— 0066 interrupt vector 27 

— 0075 re-entry point 26 

— 01 C9 screen clear 28*36-39 

— 01FE tape drive on 79 

— 02B2 cassette entry 78 

— 03E3 keyboard scan *53 

— 0674 initialization 25 

— 06 CC Level II re-entry 27,37 

— 1987 syntax error 29 

— 1A19 Level II re-entry 29 

— 1BB3 user input 117 

— 1D5A interpreter entry 71-72 

— 1D78 interpreter loop 62 

— 1E5A integer conversion 78,117 

— 28 A7 display routine 29,117 

— 3 COO video memory 38,61 

— 37E0-37EF mapped I/O 26,27,137,139,176 

— 3840 keyboard memory 26,53 

— 4000 patch points 25 

— 4012 interrupt vector 137,217 

— 4199 disk entry area 27 

— 42E9 start of program 28,117 
addressing 

— indexed 119 

— high- resolution graphics 143,148 

— peripheral 51 
AGC 96,98 
alpha decay 232 
ALPS keyboard 253 
Alternate Source, The 135 
ALU — see arithmetic logic unit 
AM radio 147 

analog 19,170 

analog- to-digital *164-166 

animals, furry 231,255 

Apparat 112,205 

appliances 231,242 

arithmetic 24,57 

arithmetic logic unit 23 

architecture 23,24,53 

arrows 11 

ASCn 53-55,67,73,138,177 



assembly programming 116 
audio 156-158 
autoexecution 71,#71 

*g* 

B-17 loader 213 

Bach, Johann Sebastian 173 

bandwidth 96 

bank select *189-193,$190-191,#193 

Barden, William 119 

bases, numeric 32 

BASEX 154 

BASIC 19,36,37,40,57,62,65,71,115 

— programs 28 

— ROMs 22,24,38 
battery eliminators 13 
baud 203,212,213 
BCD 36 

beep 58,#59 

Beta-80 tape system 212 

bidirectional 136 

binary 21,24,*32-34,35,36,79,178 

— digit 24 

— division 36 

bit 24,33,65,77,203 

— storage cost per 204 
black box 19,35 
Boolean algebra 34 
bootstrap 27,152 
break (function) 141 
break (key) 26,56,73,78 
bridges, solder 107 

buffer (hardware) 35,44,129,136,166,170,177, 
178-179,222 

— inverting 178 

buffer (software) 59,137,138,155 

buffered cable 15,91,122-124,244 

buffering 42 

bugs 242 

bus 23,44,135,187 

bus wire 10 

busy 177 

bypass capacitor 15,122,227 

byte 25,33,65,78,205 

BYTE 118,119 

cable 

— buffered 15,91,122-124,244 

— cassette 250 

— disk 248 

— interconnect 244,256 

— keyboard 2 1,22*229 

— multiconductor 17 

— rainbow 17 
capacitor 10,11,13,109 

— bypass 15,122,227 

— electrolytic 13 

— - for video twitch 254 

— variable 11 

cartridge, eight-track 217,*219-221 
cassette 42,58,130,132,203,211-212 
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— alignment 249 

— cleaning 249 

— diagnostic 238 

— hardware description *156-158 

— input/output (software) *78-83 

— maintenance 235,249-250 

— output circuitry *48-49,$49 

— relay replacement 142,249,250 

— reliability 203 

— XRX modification 111,250 
central processing unit 22,23,24,27,42 
character generator 42,46,146,254 
chassis ground 11 

checksum 80,213 

CHR$ 64,66,75,107,131 

cleaning *86 

CLEAR 40 

CLOAD 67,71-72,182 

clock 

— flip-flop 35 

— CPU master *42,$42,134,136 

— high- resolution 146 

— high-resolution 146 

— real-time 121,*182-188,$183,$185-186, 
#183-184,#187,#188-189,#192-193 

— speed increase 110-1 12,$110,$1 12 
clock-calendar 184-189 

cloning 161 
CLS *36-39,#39 
CMD 137 
cold start 153 
color codes *17 
Color Computer 41,143 
common ground 11 
comparator 222 
compiler 154 
composite video 96,104 
condition code 38 
conditions 70 
contact 

— keyboard 

— cleaner 99 
control codes 55 
conversions, numeric 32 

— hexadecimal 73 

converters — see digital-to-analog 

— see analog- to- digital 
cosmetics *96 
counter (hardware) 36 
counter (software) 54 

CPU — see central processing unit 

Craig tape deck 221 

crash 121,122,124,192,229,232 

crystal 11,146 

CSAVE 67,157,182 

CTR-41 tape deck 142,211 

CTR-80 tape deck 249 

custom interpreter 62, #62 

cutters 8 



*rj* 

D/A — see digital-to-analog 
damage 85-86 
data 24 
- bus 24,199-201 

— separator 246 

— sheets following 36 
debouncing 58,#59 
decimal numbering 32 

decoding 35,42,110,121,167,170,177 

decrement 38,118 
demultiplexer 48 
derating, temperature 123 
despooler 138 
diagnostic routines 236-239 
Digi-Key Corporation 127,184 
digital delay line 126,251,252 
digital logic *34-36 
digital-to-analog 164,171,173 
dimmers, light 254 
DIN connector 98,123 
diode 10,11 
DIP 45,214 

— shunt 90,252 

— switch 90,179 
dirt 248 

disk 

— alignment 247 

— BASIC 25 

— cleaning 247 

— controller 206-207 

— drive 19,26,27 

— floppy 204 

— maintenance 236,246 

— quality 246 

— reliability 203 

DOS 40,63,137,141,205,248 

— descriptions 209 
dots 46,104,143-151 
drills, hobby 94 
drive select signal 206 
Dust- Off 99 

Dvorak keyboard 76,94 
dynamic memory 44,45,77,87,200 

earth ground 11 

edge card connector 12,23,43,121,122,131,136, 
*175,*187,235,243-244 

— cleaning *233,247 

— plating 243-244 

edge connector (female) 127,187 

editing 58 

Editor/ Assembler *60-61 

— video driver modification #66-67 
EDTASM — see Editor/ Assembler 
eight-track mass storage *217-228,$222-224, 
#225-228 

Electric Pencil 98,109,116,131,136 
electronic music — see music 
enable 104 
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Engineer's Notebook 10,13,164 
ENTER key 28 
envelope 170-174 
EPROM 112,152 

— bank select *189-193,$190-191,#193 
error 58 

— checking 155 

— checksum 80,213- 

— L3 error 28,62 

— OM error 29,64,90 

— SN error 29,62,64,68,74 

— soft 232 

— tape 203-204 
Exatron 233 

Exatron Stringy-Floppy 83,123,167,204*210-211, 
213,217 

— maintenance 236 
exclusive OR 179 
execution routine 155 

— auto71,#71 
expansion interface 20,121 

— bus 187 

— clock speed-up 126 

— memory expansion *91 

— opening *124-126 

— reset modification *91-92,252 
extension cords 231 

*p* 

Farad 17 

Fastload tape system 203*211-212 

FDC — see floppy disk controller 

file (metal) 8,244 

filter, low-pass 49 

filtering 14,164,242 

flip-flop 35,36,183 

floating point accuracy 246 

floppy disk controller 26,27,205*206-207 

fluorescent lights 231 

flux — see solder, flux 

formatting, eight- track 225 

form-feed 70 

FOR-NEXT 38,40 

FORTH 154 

FORTRAN 115,154 

front panel *199-201,$201 

functional schematics 12 

furry animals 231,255 

fuse 242 

garbage collection 241 
gates *34-36 

— AND 34 

— Exclusive OR 179 

— NAND 35,141,142 

— NOR 35 

— OR 34,38,179 

— TTL diagrams following 36 
gold plating 243 

GOSUB 36,37,40 



GOTO 36,37 

graphics characters 65 

graphics, high-resolution *143-151,$144-146, 

$147,#149 

Gray code 36 

grommets 21 

ground 11*89,123,242 

Gunn, David 167 

*pj* 

HALT diagnostic 237 

hardware 

— description 42 
head, read/write 206 
heartbeat 25 
hexadecimal 18,66 
high-level language 115 
high-speed 

— diagnostic 238 

— laders 213 

— see also clock, speed increase 
Hobbyworld Electronics 184 
Hofstadter, Douglas 65 

home- cursor 70 
hook 63 
hot chassis 97 
house current 14,19 
humidifier 231 

#j# 

I/O — see input/output 
increment 38,80,118 
index 

— hole 205 

— pulse 206 
indexed addressing 119 
initialization 137,225 

— see also power-up 
INKEY$ 27,47,53,58,59,75-76 
input 19,162 

— diagnostic 237 
INP177 
INPUT 28,78 
input/output 20,24 
instruction 23,167 

— AND 26,53 

— CALL 26,37,78-79,135 

— DI 25,27 

— DJNZ 26 

— EI 137 

— HALT 91,141 

— IM0, IM1, IM2 135-136 

— JUMP 37 

— LDIR 25,27 

— NOP 141 

— OR 28 

— RLC 53 

— RRA 81 

— RST 28,56,135 

— XOR 25,53,80 
integrated circuit 12,13,19 

— families 13 
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— handling *89 

— pins 33 

interfacing 162-164,$163,170 ,*179-181,$180 

— printer *175-177 

— synthesizer *1 66-174 
interpreter 24,58*62-65,78*154-155 

— custom #62 

interrupt 25,27*134-140,183,217 

— diagnostic 

— modes 136 
inverter 35 

*J* 

Jameco Electronics 98-99 

jitter 147 

jumpers, programming 22 

*K* 

KBFIX 99,117,253 
keyboard 58,130,132 

— additional *93-96 

— cable 21,22,88*229-230 

— cleaning 99,253 

— comparison (photos) 105 

— debouncing #59,99 

— display routine #55 

— general description 24,42 

— hardware description *46-47,$46 

— hexadecimal *98-102,$101 

— lockout 86 

— matrix 38 

— PEEK process 75 

— scan *53-56 
keyboard (CPU) unit 143 

— memory expansion 89-90 
keybounce 131 

— see also debouncing, keyboard 
keycaps 99,235 

— lifting tool 99 

*L* 

Lab Service Inc. 142 

label 61 

Lancaster, Don 98 

latch 36,48, 121, 166-167J166, 199-201,$201 

leap year 184 

LED 87-88,100,162,199 

— infrared 214 

— power 230 

— tri- color 112 

Level I 22,38,*40-41,42,112 

— combined with Level II *112-1 14 

— ROMs 47,89,152 

Level 1122,24,28,37,38*40-41,42,57,58,63,66, 
136,139,189 

— combined with Level 1*112-114 

— in PMC-80 129 

— interconnect cable 91,98 

— ROMs 48,$48,68,98,111,152 

— ROMs, two-chip 111,113 
Level III 25*40-41,62, 182,209 



Lien, David 112 
lightning 232 

— arrestor 243 
Lindsly, Jerry 120 
line numbers 115 

linear predictive coding 169 

lines, high-resolution 148, #149-150 

LISP 154 

LIST 68,*70 

LLIST 70,138,175 

LNW 15,92,126 

— expansion board *126-129,252 

— LNW-80 132 
loaders, special 81-83 

lowercase 56,58-60,#59-60,*106,$106,254 

— see also uppercase, video memory 
low- level language 115 

LPRINT 64,65,138,175 
LSI 89,121 
lubrication 247 

*M* 

machine cycle 141,167 

machine language *36-39,40,66-69,135,212 

— instruction 167 see also instruction 

— monitor 72-73,#72-74,153,#154-158 
magnets 256 

maintenance of system 235-236 

mass storage *203-228,$216,$222-224,#213-216, 

#217-219,#225-228 

mathematic functions 58 

measurement 161 

memory 24 

— bank select *189-193,$190-191,#193 

— conservation of 116 

— crashes 121,244-245 

— dynamic 44,45,77,87,122 

— expansion *86-91 

— map 24*38-39,189,192 

— map, high-resolution 148 

— map table 39 

— mapping 26,184 

— older 245 

— slow 244 

— write- protected 192 

— speed (access time) 87,222 

— test 77,#74-76 

memory sidecar 192,$194-195,196,#197-199 
MEMORY SIZE? 25,28,29,36,61,64,81,90,113, 
124,142,153,233,241 

— resetting *74 

— setting 29,*40 
microphonics 91,122 
microprocessor 23,152,199 
Microsoft 114 
Microtek 15 

mode (interrupts) 135-136 

monitor (hardware) *199-201,$201 

monitor (software) - see machine language monitor 

monitor, power supply 242 

monitor, video 122 

— see also video monitor 
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motor 162,205 

— stepping 204 
multiconductor cable 10 
multimeter 9 
multiplexer 36 
multiplexing 42 

music *166-174,$166-167,$170-$172,#169, 
#171-174 

nanofarads 15 

nanoseconds 87 

National Parts 23 

nesting 155 

NEW 58,*73-74,#74 

NMI*135,141 

noise 15,91,122,123,129,233 

non-maskable interrupt 135 

number systems *31-34 

numeric conversions 57 

nut driver 8 

ohms 13,17 

OPEN 73 

open-collector 162,$163,172 

opening the computer 21,*87-88 

opening the expansion interface *124-126 

operand 61,119 

operational amplifier 222 

opto-isolator 254 

oscilloscope 9,157*234-235 

OUT 103-105,111-112,114,173,177,192 

output controls *48-50,162 

— diagnostic 237 

*p* 

package 24,33 

packing 66 

pad 12 

paint 96 

PAIA 169 

paper tape reader *214-217,$216,#217-219 

parentheses 38 

patch point 63,116 

PEEK 65,75-76,177,232,241 

peripheral 169 

— interface, programmable 171,179 
Personal Micro Computers Inc. 129 
phantom bit 107 

phase-shift 50 
piggyback 

— integrated circuits 103,106-108,111,113 

— sockets 93 
pin numbers 12 

— diagrams, TTL following 36 

— how to read *33 
pins, bent 245 
pixel, 143 

pliers 8 

PMC-80 *129-134 

POKE 65,66,108,149,177,232,241 



polarity 13 

polling 136 

Poor Man's Floppy — see TC-8 

port 170,179,192 

— 'port FE' 49 

— 'port FF 25,49,59,78-80,177 
power 11 

— cables 242 

— drains 242 

— strip 231 

— see also power supply; AC; house current; 
voltage 

power supply 12,*13-16,$13-16,22,42,50,89,121, 
132,147 

— clock $186 

— high-resolution graphics $145 

— problems 233 

— synthesizer $171 

— transistor 251 
power-up 256 

— monitor 153 

— routines *25-29,57 
pressure pad 205-206 
PRINT 64,65,68,108 

printer 19,58,64,121, 139,*175-177,$176 

— diagnostic 238 

— maintenance 235,255 
probe, oscilloscope 234 
program counter 118,135 

pullup, pulldown — see termination 

*Q* 

Qwerty 76,98 

*R* 

Raeco 214 
rainbow cable 15 
RAM 38,42 

— damaged 86 

— dynamic 44,87,232 

— expansion 86-89 

— reserved 38,53 

— static 192,232,257 

— using 4K for expansion 127 

— video 45,106 

— write-protected 192 

— see also memory, dynamic memory, ROM 
READ 69,246 

read circuitry diagnostic 237 

read-only-RAM — see RAM, write-protected 

read/write 42,205 

READY 27,37,72,91,113,141,211 

recording 156 

reference manuals 23 

refresh 42,44,86,122,152,200 

registers 23,37,119 

— control 188 
regulation 12*13-16 
regulators 12 
relative branch 118 
relative subroutine 119 
relay, cassette 142,249 
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reliability, tape 78-83,203 
relocatable code *115-120 
REM 65,70 
repeating keys 58,#59 
reset button 92,135,141 

— expansion modification *91-92 

— keyboard modification *92-93,252 
resistor 10,11,12,13 

— termination 15,92,123,128,251,252 

— variable 11 
restart 114 

reverse video *103-105,$103 

RFI (radio frequency interference) 255 

RF modulator 50,96*98,130,132 

rollover 54 

ROM 38,40,42,60,68,98,116,120,131,138 

— bank select *189-193,$190-191,#193 

— control *47-48 

— Level 1*112-113 

— replacement *152,$152 
RPGII115 

RS-230 121-123,246 

— maintenance 235,246 
RUN 71 

*S* 

saltwater 231,256 

Sams publications 10 

scalpel 8 

schematics *10-12 

Schmitt trigger 162 

scratches 96 

screwdriver 8 

Scripsit 131 

scroll 136-137 

sector 205 

sensor, foil 222 

serial-to-parallel conversion 79,157 

serialization 156 

servicing interrupts *135-140 

shield 14 

— RFI 255 

shift key 54-55,95 

shift register 36 

shock hazard 97 

shockproofing (vibration) 123,232 

shunt 45,*90,252 

signal 34,200 

signalling 161 

signals 

— BLANK 46 

— CAS 44,45,122,126,153,245 

— DAL0-DAL7 207 

— HALT 135 

— HDRV 50 

— IN 43,153,222 

— INSIG 48,49 

— INT 47,135,182,215 

— INTAK215 

— INTRQ 207 

— IORQ 43 



— KYBD 46,47 

— MEM 47 
-MREQ 43,111,122 

— MUX 44,45,122,126,153,245 

— OUT 43,103,153,222 

— OUTSIG 48,49,78 

— RAS 45,122,126,141,153,245 

— RD 43,111,153,177 

— RESET 43 

— RFSH 44 

— SYSRES 114 

— TEST 44,153 

— VDRV 50 

— VID 45,47 

— WR 43,45,153,177,192 
Silver-It 86,243 

slash 80 

smearing, video 98 
smoke 231 
socket 89,121,124 
soft error 232 
solder 9 

— braid 9 

— bridges 107,252 

— flux 52,86,107 

— iron 8,52,89 

— /silver 86 

— technique *52 

— wick 9,106 
solder joints, cold 252 
soldering iron grounding 89 

sound #67-69,*166-174,$166-167,$170-172 

— effects 70,#70,*169-173 
spacers — see grommets 

speed increase, CPU — see clock, speed increase 

speed of execution 116-118 

spikes 14 

splice, tape 219 

spooler 138,#139 

stack 40,138,241 

static 89,184 

static-free workbench 89,257 

start bit 79 

stepping motor — see motor, stepping 

storage 157 

string 40,58 

— packing *66-69 

Stringy-Floppy — see Exatron Stringy-Floppy 

subroutines 116,118 

switch box, cassette 250 

symbol table 61 

symbols *10-12 

sync (harware) 42,50,96 

sync (software) 79 

synchronization 

— oscilloscope 234 

— power line 182 

— process 79 
syntax 155 
synthesizer *169-174 
SYSTEM 71*78-80,116 
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tape, cassette — see cassette 

tape, paper — see paper tape reader 

TC-8 tape system *2 11-2 12 

Technical Referece Handbook 12,23,42,44-47,50, 

78,106 

telephone 

— bells 256 

— communications 19 
Teletype 139 

television 50,96*98,130,132,231 

temperature derating 123 

termination resistor 15,123,128,251,252 

text editing 136 

Thermo-Fax belt cleaner 107 

TIME$ 182-183 

tinning 230 

token 62*63-65,154 

tolerances * 12-1 3 

tone color 169 

tools *8-10 

TPR-1 paper tape reader *214-217 

traces 19 

transformer 1 1 

transistor 10,11 

transitions 70 

trigger (envelope) 171 

trim erase 204 

trimpot 107 

TRS-80 

— Color Computer 41 

— general description *19-21 
truth table 34 

TTL 122,162 
turnkey system 23 
tweezers 8 
twisted pair 122,245 

*tj* 

UART 129 

uppercase 56,58-59,#59-60 

— see also lowercase, video memory 
USR68 

*y* 

variable (resistor, capacitor) 11 

variables 40,58,155,241 

— string 66 
VARPTR 66-69,241 
VCO 172 

vector 63,116 
vibration 123,232 
video 25,38,58,130,136 

— alignment 235,254 

— buffer 253 

— composite 96,104 

— countdown chain 146 

— description 24,42 

— diagnostic 237 

— driver routine #63-66 

— in PMC-80 132 

— monitor, description 103 



— monitor, additional *96-98,$97 

— output circuitry *50,$50 

— RAM (memory) 45,46,65,106,143 

— reverse (complete screen) * 103 -105, $103 

— reverse (individual characters) *106-110 

— scan (beam) 143 

— tear 253 

— twitch 253 

voice input/output 19,#81-82,$83 

volt 17,162 

voltage 

— control 172 

— isolation 162 

— levels 24,164 

— power supply 12 
Votrax 169 

wafer 204 
warm start 153 
Watt 17 

waveform 80,169 
wire, bus 10 
wire- wrap 

— socket 93 

— technique *51 

— tool 8,51 

— wire 10,51 

write circuitry diagnostic 236 
write enable 206 
write-protect (disk) 204,206 
write-protect (memory) 192 

*X* 

X-acto knife 8,96,106,107 

X-ray danger 256 

XRX modification 111,250 

X3 (shunt) — see Z3 

X71 (shunt) — see Z71 

*Y* 

*Z* 

Z3 22,47,90,113,252 

Z71 22,45,90,252 

Z-80 22,37,53,60,89,117,141,167 

— block diagram 23 

— handling 89 

— interrupts * 134- 140 

— signals 43 

— technical manual 135 
Z80A251 
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Appendix I 
Parts Suppliers 



The Four Stars 

Digi-Key Corporation, Hiway 32 South, P.O. 
Box 677, Thief River Falls, MN 56701. 800 346- 
5144. COD, check, money order, credit cards. 
Volume discounts over $100; shipping, insurance 
prepaid. 

This company is in my opinion the 

hobbyist's best. Shipping is fast (five days 

from ordering to my door in Vermont), and 

most items are in stock. Their catalog is 

monthly, and items not stocked are not 

listed. All merchandise is prime; no 

bubble packs. 

QT Computer Systems, 15335 S. Hawthorne 

Blvd., Lawndale, CA 90260. 800 421-5150. COD 

under $100, check, money order; credit cards 

preferred. Quantity discounts, no insurance. 

A good hobbyist catalog similar to Digi- 
Key, with competitive prices. This is a 
new company, but they are already 
beginning to make a mark for promptness, 
exceeding courtesy, and prime parts. Their 
catalog is very complete and quite up-to- 
date. 

Advanced Computer Products, 1310 E. 
Edinger, Santa Ana, CA 92705. 800 854-8230. 
COD, check, money order, credit cards. Volume 
discounts, no insurance. 

One of the best catalogs in the business, 
prompt, but be wary of substitutions in orders. 
Specify voltages of devices and check upon 
receipt. Expect harrassment from Customer 
Service. Otherwise, they have what you can't 
get anywhere else. 

Jameco Electronics, 1355 Shoreway Road, 
Belmont, CA 94002. 415 592-8097. COD, check, 
money order, no credit cards. No discounts, no 
insurance. 

One almost wonders why to put Jameco in 
with the four best, but their selection is 
contemporary and their response prompt. 
They have items others don't have in stock for 
the popular computer hobbyist. Bubble pack 
stuff on retail store racks at Lafayette Radio 
and others. Highest prices in the business. 



And Others 

Jade Computer Products, 4901 West 
Rosecrans Ave., Hawthorne, CA 90250. 800 421- 
5500. No CODs; checks, money order; credit 
cards preferred. Quantity discounts; insurance 
under 50 lbs. 

This company works hard at immediate 
hobbyist needs and some unusual items. Get 
their catalog, but consult monthly ads in 
electronics magazines for hot items. 

Priority One Electronics, 16723C Roscoe 
Blvd., Sepulveda, CA 91343. 800 423-5633. No 
CODs; check, money order, credit cards. 
Quantity discounts, insurance. 

Priority deals for the most part in larger 
items for computer hobbyists, with only a 
token selection of small parts. This company 
concentrates on boards and naked disk drives, 
and heavier hardware. 

Hobbyworld Electronics, 19511 Business 
Center Dr., Northridge, CA 91324. 800 423-5387, 
(800 382-3651 in CA). COD ($1.25 extra), check, 
credit cards. No discounts, no insurance. 

Hobbyworld is the computer hobbyist's pop 
culture. It stocks all the hot items with a high 
turnover. Look to them for low prices on items 
you need right away. 

Electrolabs, P.O. Box 6721, Stanford, CA 
94305. 

The best part is always their funny and 
schizophrenic catalog with an honest 
selection and a wealth of good information. 
For example . . . 

"Save yourselves $6.75 and use a 25 cent 
transistor the next time your looking for a 
temperature probe." Also, TTL Family rules 
of Incest are great.) The shipping was always 
prompt and the merchandise prime. 

Not Recommended 

Active Electronic Sales, P.O. Box 1035, 
Framingham, MA 01701. 617 879-0077. 
Minimum $10, handling $2, check (wait to 
clear), money order. No discounts, no 
insurance. 

This group claims to be "The World's 
Largest International Semiconductor 
Distributor", which implies lots of stock, in 
stock. No way. All my orders have been 
returned 25 percent filled, with 50 percent 



errors. 
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APPENDIX 3 
Byte Values and Their Equivalents 



Code 


POKE displays; 


PRINT: 
w/ LC 


Edtasm Standrd 


Hex 


Dec 


Without 


With 


With 


Z80 i 


OiSCII 


Val 


Val 



L/Case 


Old LC 


New LC 


Driver 


Opcode Mi 
NOP 


eaning 


00 


@ 


gaming 


@ 


none 


NUL 


01 


1 


A 


gaming 


A 


none 


LD BC,NN 


SDH 


02 


2 


B 


gaming 


B 


none 


LD (BC),A 


STX 


03 


3 


C 


gaming 


C 


none 


INC BC 


ETX 


04 


4 


D 


gaming 


D 


none 


INC B 


EOT 


05 


5 


E 


gaming 


E 


none 


DEC B 


ENQ 


06 


6 


F 


gaming 


F 


none 


LD B,N 


ACK 


07 


7 


6 


gaming 


G 


none 


RLCA 


BEL 


OS 


8 


H 


gaming 


H 


bkspce 


EX AF f AF« 


BS 


09 


9 


I 


gaming 


I 


bksp lin 


ADD HL,BC 


HT 


OA 


10 


J 


gaming 


J 


Linefeed 


LD A, {BO 


LF 


OB 


11 


K 


gaming 


K 


none 


DEC BC 


VT 


DC 


12 


L 


gaming 


L 


formfeed 


INC C 


FF 


OD 


13 


M 


gaming 


M 


car retn 


DEC C 


CR 


OE 


14 


N 


gaming 


N 


crsr on 


LD C,N 


SO 


OF 


15 





gaming 





crsr off 


RRCA 


SI 


10 


16 


P 


gaming 


P 


none 


DJNZ d 


DLE 


11 


17 


Q 


gaming 


0. 


none 


LD DE.NN 


DC1 


12 


18 


R 


gaming 


R 


none 


LD (DEJ,A 


DC2 


13 


19 


S 


gaming 


S 


none 


INC DE 


DC3 


14 


20 


T 


gaming 


T 


none 


INC D 


DC4 


15 


21 


U 


gaming 


U 


none 


DEC D 


NAK 


16 


22 


V 


gaming 


V 


none 


LD D,N 


SYN 


17 


23 


W 


gaming 


w 


wi demode 


RLA 


ETB 


18 


24 


X 


gaming 


X 


bkspcrsr 


JR d 


CAN 


19 


25 


Y 


gaming 


Y 


adv crsr 


ADD HL,DE 


EM 


1A 


26 


Z 


gaming 


Z 


dn linfd 


LD A, IDE) 


SUB 


1B 


27 


I brace 


gaming 


up arr 


up linfd 


DEC DE 


ESC 


1C 


28 


dn arr 


gaming 


dn arr 


home crsr 


INC E 


FS 


1D 


29 


r brace 


gaming 


leftarr 


strt crsr 


DEC E 


GS 


1E 


30 


rt arr 


gaming 


rt arr 


erase Lin 


LD E,N 


RS 


1F 


31 




gaming 




clr frame 


RRA 


US 


20 


32 


space 


space 


space 


space 


JR NZ,d 


space 


21 


33 


! 


! 


1 


! 


LD HL,NN 


! 


22 


34 


it 


it 


ii 


it 


LD {NN],HL " 


23 


35 


# 


# 


# 


# 


INC HL 


# 


24 


36 


$ 


$ 


$ 


$ 


INC H 


$ 


25 


37 


% 


% 


% 


% 


DEC H 


% 


26 


38 


& 


a 


& 


a 


LD H,N 


& 


27 


39 


« 


1 


i 


1 


DAA 


i 


28 


40 


[ 


t 


[ 


[ 


JR Z,d 


[ 


29 


41 


) 


) 


J 


) 


ADD HL,HL 


) 


2A 


42 


* 


# 


* 


# 


LD hl,[nn: 


1 * 


2B 


43 


+ 


+ 


+ 


+ 


DEC HL 


+ 


2C 


44 


? 


* 


t 


7 


INC L 


p 


2D 


45 


- 


- 


- 


- 


DEC L 


— 


2E 


46 


„ 


a 


a 


■ 


LD L ? N 


m 


2F 


47 


/ 


/ 


/ 


/ 


CPL 


/ 


30 


48 














JR NC f d 
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Code 


POKE display 


s: 


PRINT: 


E 


dtasm 


Standrd 


Hex 


Dec 


Without 


With 


With 


w/ LC 


Z80 


ASCII 


Val 


Val 


L/C as e 


Old LC 


New LC 


Driver 


Opcode 


Meaning 


31 


49 


1 


1 


1 


1 


LD 


SP S NN 


1 


32 


50 


2 


2 


2 


2 


LD 


INN] .A 


2 


33 


51 


3 


3 


3 


3 


■INC SP 


3 


34 


52 


4 


4 


4 


4 


INC (HL) 


4 


35 


53 


5 


5 


5 


5 


DEC (HL) 


5 


36 


54 


6 


6 


6 


6 


LD 


(HU.N 


6 


37 


55 


7 


7 


7 


7 


SCF 


7 


38 


56 


6 


8 


8 


8 


JR 


C.d 


8 


39 


57 


9 


9 


9 


9 


ADD HL.SP 


9 


3A 


58 


: 


; 


; 


i 


LD 


A. INN) 


J 


3B 


59 


J 


i 


> 


I 


DEC SP 


J 


3C 


60 


< 


< 


< 


< 


INC A 


< 


3D 


61 


= 


= 


= 


= 


DEC A 


= 


3E 


62 


> 


> 


> 


> 


LD 


A,N 


> 


3F 


63 


? 


? 


? 


? 


CCF 


? 


40 


64 


@ op 


en quote 


@ 


@ 


LD 


B,B 


@ 


41 


65 


A 


A 


A 


A 


LD 


B,C 


A 


42 


66 


B 


B 


B 


B 


LD 


B,D 


B 


43 


67 


C 


C 


C 


C 


LD 


B,E 


C 


44 


68 


D 


D 


D 


D 


LD 


B,H 


D 


45 


69 


E 


E 


E 


E 


LD 


B,L 


E 


46 


70 


F 


F 


F 


F 


LD 


B,(HU 


F 


47 


71 


G 


6 


G 


G 


LD 


B,A 


G 


48 


72 


H 


H 


H 


H 


LD 


C,B 


H 


49 


73 


I 


I 


I 


I 


LD 


C ? C 


I 


4A 


74 


J 


J 


J 


J 


LD 


C,D 


J 


4B 


75 


K 


K 


K 


K 


LD 


C,E 


K 


4C 


76 


L 


L 


L 


L 


LD 


C f H 


L 


4D 


77 


M 


M 


M 


M 


LD 


C,L 


M 


4E 


78 


N 


N 


N 


N 


LD 


C,[HL) 


N 


4F 


78 














LD 


C,A 





50 


80 


P 


P 


P 


P 


LD 


D,B 


P 


51 


81 


Q 


Q 


Q 


Q 


LD 


D,C 


Q 


52 


82 


R 


R 


R 


R 


LD 


D 7 D 


R 


53 


83 


S 


S 


S 


S 


LD 


D,E 


S 


54 


84 


T 


T 


T 


T 


LD 


D,H 


T 


55 


85 


U 


U 


U 


U 


LD 


D,L 


U 


56 


86 


V 


V 


V 


V 


LD 


D,[HU 


V 


57 


87 


W 


w 


W 


w 


LD 


D,A 


w 


58 


88 


X 


X 


X 


X 


LD 


E,B 


X 


59 


89 


Y 


Y 


Y 


Y 


LD 


E,C 


Y 


5A 


90 


Z 


Z 


Z 


Z 


LD 


E,D 


Z 


5B 


91 


L.brkt. 


l.brkt. i 


jp arr. 


up arr. 


LD 


E,E 


l.brkt. 


5C 


92 










LD 


E f H 


slant 


5D 


93 










LD 


E S L 


r.brkt. 


5E 


94 










LD 


E P (HLJ 


carat 


5F 


95 










LD 


E,A 


I. arr. 


60 


96 


@ op 


en quote 


pound 


@ 


LD 


H„B 


undef . 


61 


97 


A 


a 


a 


a 


LD 


H,C 


a 


62 


98 


B 


b 


b 


b 


LD 


H f D 


b 


63 


99 


C 


c 


c 


c 


LD 


H„E 


c 


64 


100 


D 


d 


d 


d 


LD 


H ? H 


d 


65 


101 


E 


e 


e 


e 


LD 


H.L 


e 



Code 


POKE 


display 


-s: PRINT: 


Edtasm Standrd 


Hex Dec l 


Without 


With 


With w/ 


LC 


Z80 ASCII 


VaL VaL 


L/Case Old LC 


New LC Driver 


Op 


code Meaning 


66 102 


F 


f 


f 


f 


LD 


H,(HL) f 


67 103 


G 


9 


g 


g 


LD 


H,A g 


68 104 


H 


h 


h 


h 


LD 


L,B h 


69 105 


I 


i 


i 


i 


LD 


L,C i 


6A 106 


J 


J 


J 


J 


LD 


L,D j 


6B 107 


K 


k 


k 


k 


LD 


L,E k 


6C 108 


L 


I 


I 


I 


LD 


L,H L 


6D 109 


M 


m 


m 


m 


LD 


L,L m 


6E 110 


N 


n 


n 


n 


LD 


L,IHL) n 


6F 111 














LD 


L,A o 


70 112 


P 


P 


P 


P 


LD 


(HL],B p 


71 113 


Qt 


q 


q 


q 


LD 


[HL],C q 


72 114 


R 


r 


r 


r 


LD 


[HLJ f D r 


73 115 


S 


s 


s 


s 


LD 


[HL),E s 


74 116 


T 


t 


t 


t 


LD 


(HL) f H t 


75 117 


U 


u 


u 


u 


LD 


(HL],L u 


76 118 


V 


V 


V 


V 


HALT v 


77 119 


W 


w 


w 


w 


LD 


[HL) ,A w 


78 120 


X 


X 


X 


X 


LD 


A,B x 


79 121 


Y 


y 


y 


y 


LD 


A,C y 


7A 122 


Z 


z 


z 


z 


LD 


A,D z 


7B 123 










LD 


A,E L. brace 


7C 124 










LD 


A,H separator 


7D 125 










LD A}L r. brace 


7E 126 










LD 


A,IHL] wave 


7F 127 










LD 


A, A delete 






Upper 


■ Character 


Set 






HEX DEC 


POKE 




BASIC 


1 


PRINT 


Z80 


VaL VaL 


DispLay: 




Keyword: 


D 


isplay : 


Opcode: 


60 128 


/G/ 


END 


/G/ 


ADD A,B 


81 129 


/G/ 




FOR 




/G/ 


ADD A,C 


82 130 


/G/ 




RESET 




/G/ 


ADD A P D 


83 131 


/G/ 




SET 




/G/ 


ADD A f E 


84 132 


/G/ 




CLS 




/G/ 


ADD A,H 


85 133 


/G/ 




CMD 




/G/ 


ADD A,L 


86 134 


/G/ 




RANDOM 




/G/ 


ADD A, [HLJ 


87 135 


/G/ 




NEXT 




/G/ 


ADD A, A 


88 136 


/G/ 




DATA 




/G/ 


ADC A f B 


89 137 


/G/ 




INPUT 




/G/ 


ADC A,C 


8A 138 


/G/ 




DIM 




/G/ 


ADC A,D 


8B 139 


/G/ 




READ 




/G/ 


ADC A,E 


8C 140 


/G/ 




LSET 




/G/ 


ADC A,H 


8D 141 


/G/ 




GOTO 




/G/ 


ADC A,L 


8E 142 


/G/ 




RUN 




/G/ 


ADC A.tHL] 


8F 143 


/G/ 




IF 




/G/ 


ADC A, A 


90 144 


/G/ 




RESTORE 




/G/ 


SUB B 


91 145 


/G/ 




GOSUB 




/G/ 


SUB C 


92 146 


/G/ 




RETURN 




/G/ 


SUB D 


93 147 


/G/ 




REM 




/G/ 


SUB E 
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Upper Character 


Set 




HEX 


: DEC 


POKE 


BASIC 


PRINT 


Z8Q 


Val 


. Val 
148 


Display: 
/G/ 


Keyword; 


Displays 
/G/ 


Opcodes 


84 


STOP 


SUB H 


95 


149 


/G/ 


ELSE 


/G/ 


SUB L 


96 


150 


/G/ 


TRON 


/G/ 


SUB [HD 


97 


151 


/G/ 


TROFF 


/G/ 


SUB A 


98 


152 


/G/ 


DEFSTR 


/G/ 


SBC A,B 


99 


153 


/G/ 


DEFINT 


/G/ 


SBC A ? C 


9A 


154 


/G/ 


DEFSNG 


/G/ 


SBC A„D 


9B 


155 


/G/ 


DEFDBL 


/G/ 


SBC A,E 


9C 


156 


/G/ 


LINE 


/G/ 


SBC A P H 


9D 


157 


/G/ 


EDIT 


/G/ 


SBC A„L 


9E 


158 


/G/ 


ERROR 


/G/ 


SBC A P [HL) 


9F 


159 


/G/ 


RESUME 


/G/ 


SBC A,A 


AD 


160 


/G/ 


OUT 


/G/ 


AND B 


A1 


161 


/G/ 


ON 


/G/ 


AND C 


A2 


162 


/G/ 


OPEN 


/G/ 


AND D 


A3 


163 


/G/ 


FIELD 


/G/ 


AND E 


A4 


164 


/G/ 


GET 


/G/ 


AND H 


A5 


165 


/G/ 


PUT 


/G/ 


AND L 


AB 


166 


/G/ 


CLOSE 


/G/ 


AND (HU 


A7 


167 


/G/ 


LOAD 


/G/ 


AND A 


A8 


168 


/G/ 


MERGE 


/G/ 


XOR B 


A9 


169 


/G/ 


NAME 


/G/ 


XOR C 


AA 


170 


/G/ 


KILL 


/G/ 


XOR D 


AB 


171 


/6/ 


LSET 


/G/ 


XOR E 


AC 


172 


/G/ 


RSET 


/G/ 


XOR H 


AD 


173 


/G/ 


SAVE 


/G/ 


XOR L 


AE 


174 


/G/ 


SYSTEM 


/G/ 


XOR ML) 


AF 


175 


/G/ 


LPRINT 


/G/ 


XOR A 


BO 


176 


/G/ 


DEF 


/G/ 


OR B 


B1 


177 


/G/ 


POKE 


/G/ 


OR C 


B2 


178 


/G/ 


PRINT 


/G/ 


OR D 


B3 


179 


/G/ 


CONT 


/G/ 


OR E 


B4 


180 


/G/ 


LIST 


/G/ 


OR H 


B5 


181 


/G/ 


LLIST 


/G/ 


OR L 


B6 


182 


/G/ 


DELETE 


/G/ 


OR (HL) 


B7 


183 


/G/ 


AUTO 


/G/ 


OR A 


BB 


184 


/G/ 


CLEAR 


/G/ 


CP B 


B9 


185 


/G/ 


CLOAD 


/G/ 


CP C 


BA 


186 


/G/ 


CSAVE 


/G/ 


CP D 


BB 


187 


/G/ 


NEW 


/G/ 


CP E 


BC 


188 


/G/ 


TAB( 


/G/ 


CP H 


BD 


1B9 


/G/ 


TO 


/G/ 


CP L 


BE 


190 


/G/ 


FN 


/G/ 


CP [HD 


BF 


181 


/G/ 


USING 


/G/ 


CP A 


CO 


192 


/G/ 


VARPTR 


/G/ 


RET NZ 


C1 


193 


/G/ 


USR 


TAB+01 


POP BC 


C2 


194 


/G/ 


ERL 


TAB+02 


JP NZ,NN 


C3 


195 


/G/ 


ERR 


TAB+03 


JP NN 


C4 


196 


/G/ 


STRINGS 


TAB+04 


CALL NZ f NN 


C5 


197 


/G/ 


INSTR 


TAB+05 


PUSH BC 


C6 


198 


/G/ 


POINT 


TAB+06 


ADD A,N 


C7 


199 


/G/ 


TIMES 


TAB+07 


RST OOH 
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Upper Character 


Set 




HEX DEC 


POKE 


BASIC 


PRINT 


Z80 


VaL Val D 


ispLay : 


Keyword: 


DispLay: 


Opcode: 


C8 200 


/G/ 


MEM 


TAB+08 


RET Z 


C9 201 


/G/ 


INKEY$ 


TAB+09 


RET 


CA 202 


/G/ 


THEN 


TAB+10 


JP Z, NN 


CB 203 


/G/ 


NOT 


TAB+11 


<Note 1> 


CC 204 


/G/ 


STEP 


TAB+12 


CALL Z,NN 


CD 205 


/G/ 


+ 


TAB+13 


CALL NN 


CE 206 


/G/ 


- 


TAB+14 


ADC A,N 


CF 207 


/G/ 


# 


TAB+15 


RST 08H 


DO 208 


/G/ 


/ 


TAB+16 


RET NC 


D1 209 


/G/ 


** 


TAB+17 


POP DE 


D2 210 


/G/ 


AND 


TAB+18 


JP NC.NN 


D3 211 


/G/ 


OR 


TAB+19 


OUT [N),A 


D4 212 


/G/ 


> 


TAB+20 


CALL NC,NN 


D5 213 


/G/ 


= 


TAB+21 


PUSH DE 


D6 214 


/G/ 


< 


TAB+22 


SUB N 


D7 215 


/G/ 


SGN 


TAB+23 


RST 10H 


D8 216 


/G/ 


INT 


TAB+24 


RET C 


D9 217 


/G/ 


ABS 


TAB+25 


EXX 


DA 218 


/G/ 


FRE 


TAB+26 


JP C,NN 


DB 219 


/G/ 


INP 


TAB+27 


IN A,[N) 


DC 220 


/G/ 


POS 


TAB+28 


CALL C,NN 


DD 221 


/G/ 


SQR 


TAB+29 


<Note 2> 


DE 222 


/G/ 


RND 


TAB+30 


SBC A,N 


DF 223 


/G/ 


LOG 


TAB+31 


RST 1BH 


EO 224 


/G/ 


EXP 


TAB+32 


RET PO 


E1 225 


/G/ 


COS 


TAB+33 


POP HL 


E2 226 


/G/ 


SIN 


TAB+34 


JP PO,NN 


E3 227 


/G/ 


TAN 


TAB+35 


EX (SP),HL 


E4 228 


/G/ 


ATN 


TAB+36 


CALL PO,NN 


E5 229 


/G/ 


PEEK 


TAB+37 


PUSH HL 


E6 230 


/G/ 


CVI 


TAB+38 


AND N 


E7 231 


/G/ 


CVS 


TAB+39 


RST 20H 


E8 232 


/G/ 


CVD 


TAB+40 


RET PE 


E9 233 


/G/ 


EOF 


TAB+41 


JP [HL) 


EA 234 


/G/ 


LOC 


TAB+42 


JP PE,NN 


EB 235 


/G/ 


LOF 


TAB+43 


EX DE,HL 


EC 236 


/G/ 


MKI$ 


TAB+44 


CALL PE,NN 


ED 237 


/G/ 


MKS$ 


TAB+45 


<Note 3> 


EE 238 


/G/ 


MKD$ 


TAB+46 


XOR N 


EF 239 


/G/ 


CINT 


TAB+47 


RST 28 H 


FO 240 


/G/ 


CSNG 


TAB+48 


RET P 


F1 241 


/G/ 


CDBL 


TAB+49 


POP AF 


F2 242 


/G/ 


FIX 


TAB+50 


JP P,NN 


F3 243 


/G/ 


LEN 


TAB+51 


DI 


F4 244 


/G/ 


STR$ 


TAB+52 


CALL P,NN 


F5 245 


/G/ 


VAL 


TAB+53 


PUSH AF 


F6 246 


/G/ 


ASC 


TAB+54 


OR N 


F7 247 


/G/ 


CHR$ 


TAB+55 


RST 3 OH 


F8 248 


/G/ 


LEFT$ 


TAB+56 


RET M 


F9 248 


/G/ 


RIGHT? 


TAB+57 


LD SP,HL 


FA 250 


/G/ 


MID$ 


TAB+58 


JP M,NN 


FB 251 


/G/ 




TAB+59 


EI 
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Upper Character Set 



HEX 
Val 


DEC 
Val 

252 
253 
254 
255 


POKE 
Display: 

/G/ 
/G/ 
/G/ 
/G/ 


BASIC 
Keyword: 


PRINT 
Display: 

TAB+60 
TAB+61 
TAB+B2 
TAB+B3 


ZBO 
Opcode: 


FC 
FD 
FE 
FF 


CALL M,NN 
<Note 4> 
CP N 
RST 38H 









Note 1: CB includes RLC, RRC, RL, RR, SLA, SRL, BIT, 

RES, SET. 

Note 2: DD includes IX register manipulations. 

Note 3: ED incLudes misceL Laneous IN, OUT, LD, and ADC 

functions as well as block move and 
compare commands, and interrupt 
mode setting and handling. 

Note 4: FD includes IY register manipulations,, 



Graphics Note: In the table above /G/ means a graphics 
character wi I L be displayed. The table beLow shows the 
graphics characters and their ASCII code in decimaL. 

135 f>» 
139 Tj 
143 H 

t £L~7 ^^ 

151 f 
155 5 
159 p 

163 m 

m 

167 P 

m 

171 «j 

175 ^ 

EH 

183 g 

187 3 

191 



128 




132 


D 


136 


□ 


140 


G& 


144 


m 


148 


1 


152 


J 


156 


w 


160 


m 


164 


\ 


168 


i 


172 


n 


176 


m 


180 


k 


184 


J 


188 


DR 



129 


□ 


133 


i 


137 


t§ 


141 


b 


145 




149 


1 


153 




157 


¥ 


161 


n 

H 


165 


1 

® 


169 


1 


173 


% 


177 


■ 


181 


lb 


185 


us! 



130 


3 


134 


III 


138 


D 


142 


J 


146 


a 


150 


if 

I 


154 


# 


158 


[P 


162 


■ 


166 


if 

11 


170 


1 


174 


4 


178 




182 


IS 


186 


J 


190 


ui 
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4099 
03FB 
403D 
401A 
4019 
4004 
40A0 
40 EB 
40FD 
06CG 
40B1 
4000 
0264 
1D78 
3C00 

3039 



00100 

00110 

00120 

00130 

00140 

00150 

00160 

00170 

00180 

00190 

00200 

00210 

00220 

00230 

00240 

00250 

00260 INKEYS 

00270 KYSCAN 

00280 PORTFF 

00290 KPLACE 

00300 SHIFTR 

00310 RESTRT 

00320 STGEND 

00330 STACKR 

00340 VAREND 

00350 READY 

00360 HEHTOP 

00370 SETPTS 

00380 WRTBYT 

00390 BYTE 

00400 VIDEO 

00410 ; 

00420 



* * * 


* * 


K 


E E P I T 


3 


. 2 


* * 


* # * 


»» 




SYSTEM /12345 


TO 


ENTER 




«« 


»» 




USE 


'READ 


FOR 


MENU 




«« 



COPYRIGHT (C) 1980, 1981 BY DENNIS BATHORY KITSZ 
ALL RIGHTS RESERVED. NO PART OF THIS PROGRAM HAY 
BE REPRODUCED BY ANY MEANS, ELECTRONIC, ELECTRO- 
MECHANICAL, OR IN PRINT, WHETHER BY METHODS IN 
USE OR CONCEIVED IN THE FUTURE, WITHOUT SPECIFIC 
WRITTEN PERMISSION OF THE AUTHOR. 



EOU 
EQll 
EOil 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 

ORG 



4099H 
03FBH 
403DH 
401AH 
401 9H 
4004H 
40A0H 
40E8H 
40FDH 
OBCCH 
40B1H 
4000H 
026 4H 
1D7BH 
3C00H 

3039H 



INKEYS BYTE STORAGE AREA 
KEYBOARD SCAN ROUTINE 
CASSETTE OUTPUT PORT 
1-BYTE KEYSTROKE STORE 
STORAGE FOR LC DRIVER 
BASIC INTERP PATCH POINT 
END OF STRINGS POINTER 
BASIC STACK POINTER 
END OF VARIABLE POINTER 
RETURN TO READY INTACT 
TOP OF BASIC MEMORY 
SETPOINT RESTART ADDRESS 
ROM BYTE WRITE ROUTINE 
ROM READ KEYS & TOKENIZE 
FIRST SCREEN LOCATION 



00430 ; PREPARE RAM AREAS FOR USE 



3039 2AB140 
303C ED5BA040 

3040 0607 

3042 2B 

3043 1B 

3044 10FC 
3046 22B140 
3049 ED53A040 
304D 23 

304E E5 
304F FDE1 



3051 
3053 
3056 
3D5A 
305D 
3060 
3063 
3066 
3069 
306C 
306D 
306E 
30BF 
3072 
3073 



3 ECS 

FD7700 

ED5B0440 

FD7301 

FD720E 

FD7703 

117631 

FD7304 

FD7205 

23 

23 

23 

220440 

AF 

321940 



OD440 START 

00450 

00460 

00470 

00480 

00490 

00500 

00510 

00520 

00530 

00540 

00550 

00560 

00570 

00580 

00590 

00600 

00610 

00620 

00630 

00640 

00650 

00660 GRINS 

00670 

00680 

00690 

00700 

00710 



LD HL,(40B1H) 

LD DE,(40A0H) 

LD B,7 

DEC HL 

DEC DE 

DJNZ S-2 

LD (40B1HJ.HL 

LD (40A0H) ,DE 

INC HL 

PUSH HL 

POP IY 
READY INTERPRETER VECTOR PATCH 

GET CURRENT CONTENTS OF 40D4H 



LD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

LD 

INC 

INC 

INC 

LD 

XOR 

LD 



A.0C3H 

[IY+OJ,A 

DE, (RESTRT) 

(IY+D.E 

UY+2J ,D 

(IY+3) ,A 

DE.SKPSTP 

(IY+4J.E 

(IY+5),D 

HL 

HL 

HL 

(RESTRT), HL 

A 

(SHIFTR), A 



3076 CDC901 
3079 CD611B 
307C 211101 
307F CDA72B 
30B2 C3CC06 

3085 213640 
30B8 010138 
308B 1600 

30BD OA 
30BE 5F 
308F A3 
3090 2018 

3092 77 

3093 14 

3094 2C 

3095 CB01 

3097 79 

3098 06B0 
309A 20F1 

309C 0607 
309E 2D 
3D9F 86 
30A0 10FC 
30A2 A7 



00720 ; CALL CLEAR AND RETURN TO BASIC 

00730 RSLVII CALL 01C9H 

00740 CALL 1B61H 

00750 LD HL,0111H 

00760 CALL 28A7H 

00770 JP READY 

007 SO ; START KEYBOARD SCAN 

00790 KBPFIX LD HL.4036H 

00800 LD BC,3801H 

00810 LD D,0 

00820 ; CHECK EACH ROW OF KEYS 



LD 

LD 

AND 

JR 

LD 



A.IBC) 

E,A 

E 

NZ, STROKE 

(HL) ,A 
INC AND ROTATE TO CHECK NEXT ROW 
INC D 

INC L 

RLC C 

LD A,C 

CHECK IF LAST ROW (NOT INCL. SHIFT] 
SUB BOH 

JR NZ.KEYPRS 

CHECK IF KEYBOARD CLEAR 

B,7 

L 

A,(HL) 

CLRMEM 

A 



00B30 KEYPRS 

00840 

00850 

00860 

00870 

00880 

00890 RECHEK 

00900 

00910 

00920 

00930 

00940 

00950 

00960 

00970 LD 

00980 CLRMEM DEC 

00990 ADD 

01000 DJNZ 

01010 AND 



30A3 


3E00 


01020 




LD 


A,0 




30A5 


CO 


01030 




RET 


NZ 








01040 


RESET AUTOREPEAT DELAY TO 




30A6 


321A40 


01050 




LD 


(KPLACE), A 




30A9 


C9 


01060 




RET 










01070 


; IF KEYSTROKE FOUND CHECK AUTOREPEAT 


LOOP 


30AA 


A6 


01080 


STROKE 


AND 


(HL) 




30AB 


281 E 


01090 




JR 


Z, FOUND 




30AD 


3A9940 


01100 




LD 


A, (INKEYS) 




30B0 


A7 


01110 




AND 


A 




30B1 


2DE0 


01120 




JR 


NZ, RECHEK 




30B3 


3A1A40 


01130 




LD 


A, (KPLACE) 




30B6 


3C 


01140 




INC 


A 




30B7 


321 A40 


01150 




LD 


(KPLACE) ,A 




30BA 


FEFF 


01160 




CP 


OFFH 




30BC 


2808 


01170 




JR 


Z.DECA 




30BE 


C5 


01180 




PUSH 


BC 




30BF 


06FF 


01190 




LD 


B.OFFH 




30C1 


10FE 


01200 


TMWSTE 


DJNZ 


TMWSTE 




30C3 


C1 


01210 




POP 


BC 




30C4 


18CD 


01220 




JR 


RECHEK 




30C6 


30 


01230 


DECA 


DEC 


A 




30C7 


321 A40 


01240 




LD 


[KPLACE), A 








01250 


; GET AND SAVE FOUND KEYBOARD BYTE 




30CA 


7B 


01260 




LD 


A,E 




30CB 


73 


01270 


FOUND 


LD 


(HL),E 




30CC 


7A 


01280 




LD 


A,D 




30CD 


07 


01290 




RLCA 






30CE 


07 


01300 




RLCA 






30CF 


07 


01310 




RLCA 






30D0 


57 


01320 




LD 


D,A 




30D1 


0E01 


01330 




LD 


C,1 




30D3 


79 


01340 


BACKUP 


LD 


A,C 




30D4 A3 


01350 




AND 


E 




30D5 


2005 


01360 




JR 


NZ, AROUND 




30D7 


14 


01370 




INC 


D 




3QD8 


CB01 


01380 




RLC 


C 




30DA 


18F7 


01390 




JR 


BACKUP 




30DC 


3AB038 


01400 


AROUND 


LD 


A,(38B0H) 




30DF 


47 


01410 




LD 


B,A 




30E0 


7A 


01420 




LD 


A,D 




30E1 


C640 


01430 




ADD 


A,40H 




30E3 


FE60 


01440 




CP 


60H 




30E5 


3016 


01450 




JR 


NC.Z0429H 




30E7 


57 


01460 




LD 


D,A 




30EB 


3A4038 


01470 




LD 


A,(3B40H) 




30EB 


E610 


01480 




ANO 


10H 




30ED 


2009 


01490 




JR 


NZ, CNTROL 




30EF 


7A 


01500 




LD 


A,D 




30FO 


CB08 


01510 




RRC 


B 




30F2 


3830 


01520 




JR 


C, GOAWAY 




30F4 


C620 


01530 




ADD 


A,20H 




30F6 


1839 


01540 




JR 


GOAWAY 




30FB 


7A 


01550 


CNTROL 


LD 


A,D 




30F9 


0640 


01560 




SUB 


40H 




30FB 


1834 


01570 




JR 


GOAWAY 




30FD 


0670 


01580 


Z0429H 


SUB 


70H 




30FF 


3010 


01590 




JR 


NC.Z043DH 




3101 


C640 


01600 




ADD 


A,40H 




3103 


FE3C 


01610 




CP 


3CH 




3105 3B02 


01620 




JR 


CZ0435H 




3107 


EE10 


01630 




XOR 


10H 




3109 


CBOB 


01640 


Z0435H 


RRC 


B 




31 OB 


3024 


01650 




JR 


NC, GOAWAY 




310D 


EE10 


01660 




XOR 


10H 




310F 


1B20 


01670 




JR 


GOAWAY 




3111 


07 


01680 


Z043DH 


RLCA 






3112 


CBOB 


01690 




RRC 


B 




3114 


3001 


01700 




JR 


NC.Z0443H 




3116 


3C 


01710 




INC 


A 




3117 


212131 


01720 


Z0443H 


LD 


HL, TABLET 




311A 


4F 


01730 




LD 


C,A 




311B 


0600 


01740 




LD 


B,0 




311D 


09 


01750 




ADD 


HL.BC 




311E 


7E 


01760 




LD 


A,(HL) 




311F 


1810 


01770 




JR 


GOAWAY 




3121 


ODOD 


01780 


TABLET 


DEFW 


ODODH 




3123 


1F1F 


01790 




DEFW 


1F1FH 




3125 


0101 


01800 




DEFW 


0101H 




3127 


5B1B 


01810 




DEFW 


1B5BH 




3129 


OAOO 


01820 




DEFW 


OOOAH 




31 2B 


0818 


01B30 




DEFW 


1B08H 




31 2D 


0919 


01840 




DEFW 


1909H 




31 2F 


2020 


01850 




DEFW 


2020H 




3131 


57 


01860 


GOAWAY 


LD 


D,A 




3132 


3A103B 


01870 


BEEEEP 


LD 


A, (381 OH) 




3135 


FE01 


018B0 




CP 


1 




3137 


2016 


01890 




JR 


NZ.BLEEEP 




3139 


3A8038 


01900 




LD 


A,(3B80H) 




313C 


FE01 


01910 




CP 


1 




313E 


200F 


01920 




JR 


NZ.BLEEEP 




3140 


3A1940 


01930 




LD 


A, (SHIFTR) 




3143 


EE01 


01940 




XOR 


1 
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3145 321940 
3148 010005 
31 4B CDB000 
314E C9 

31 4F 01BD01 
3152 CD6D00 
3155 7A 



3156 
3157 
3158 
31 5A 
3150 
31 5F 
3160 
3162 
3163 
3164 
3166 
3167 
3189 
31 6A 
316C 
316E 
31 6F 
3171 
3172 
3173 



C5 

F5 

0640 

3A3D40 

E6FD 

67 

F602 

6F 

70 

D3FF 

7C 

D3FF 

C5 

0640 

10FE 

C1 

10F2 

F1 

01 

C35204 



3176 

3176 E3 

3177 70 

3178 FE5B 
31 7A 2003 
317C 7C 
3170 FE1D 
317F E3 
3180 027810 

3183 CD781D 
3186 FECF" 
3188 2803 
31 8A 2B 
3188 FDE9 
31 8D CD781D 

3190 CABE31 



3193 
3195 
3197 
3199 
319B 
31 9D 
31 AO 
31A2 
31A5 
31A7 
31AA 
31AC 
31AE 
3180 
3182 
31 B4 
31 B6 
31 B8 
31 BA 
31 BC 
31 BE 

31 C1 
31C4 
31 C7 
31CA 
31CD 
3100 
3103 
31 D6 
3109 



FEAD 

287F 

FEBB 

2866 

FEA2 

CAE432 

FECC 

CA8034 

FEC8 

CACE34 

FEF2 

284A 

FEB2 

2829 

FEAO 

283A 

FEAA 

282E 

FE8B 

2B03 

C39719 

213B35 
CDA72B 
21A335 
CDA72B 
214236 
CDA72B 
210836 
0DA72B 
1823 



31DB 3E01 
3100 321940 
31 EO 211035 
31 E3 221 E40 
31EB 1816 

31 E8 215804 
31 EB 221 E40 
31EE 180E 

31F0 21E303 
31F3 221640 
31F6 1806 



01950 

01960 

01970 

01980 

01990 

02000 

02010 

02020 

02030 

02040 

02050 

02060 

02070 

02080 

02090 

02100 

02110 

02120 

02130 

02140 

02150 

02160 

02170 

02180 

02190 

02200 

02210 

02220 

02230 

02240 

02250 

02260 

02270 

02280 

02290 

02300 

02310 

02320 

02330 

02340 

02350 

02360 

02370 

02380 

02390 

02400 

02410 

02420 

02430 

02440 

02450 

02460 

02470 

024B0 

02490 

02500 

02510 

02520 

02530 

02540 

02550 

02560 

02570 

02580 

02590 

02600 

02610 

02620 

02630 

02640 

02650 

02660 

02670 

02680 

02690 

02700 

02710 

02720 

02730 

02740 

02750 

02760 

02770 

02780 

02730 

02800 

02810 

02B20 

02B30 

02840 

02850 

02B60 

02B70 



LD 
LD 

CALL 
RET 
; DEBQUNCE 
BLEEEP LD 

CALL 
LD 



(SHIFTH) ,A 

BC5D0H 

0060H 



BC.1BDH 

0060H 

A.D 



; BEEP ROUTINE ON FOUND KEYSTROKE 

PUSH BC 

PUSH AF 

LD B.40H 

LD A.IPORTFF) 

AND OFDH 

LD H,A 

OR 2 

LD L,A 

BEEPER LD A,L 

OUT (OFFHi.A 

LD A,H 

OUT (OFFHJ.A 

PUSH BC 

LD B.40H 

FREQCY DJNZ FREOEY 

POP BC 

DJNZ BEEPER 

POP AF 

POP BC 

JP 0452H 
; CHECK FOR STATUS OF BASIC STACK 

SKPSTP EQU S 

BEGIN EX (SP),HL 

LD A,L 

CP 5BH 

JR NZ.NOTRDY 

LD A,H 

CP 1DH 

NOTRDY EX [SP) ,HL 

JP NZ.BYTE 

; CHECK TO SEE IF SPECIAL STAR (*) COMMAND 



OKSTAR 



CALL 

CP 

JR 

DEC 

JP 

CALL 

JP 



BYTE 

OCFH 

Z, OKSTAR 

HL 

(IY) 

BYTE 

Z , SYNERR 



CHECK STATUS OF SAVE COMMAND 



SAVE 



SYNERR 



CP 
JR 
CP 
JR 
CP 
JP 
CP 
JP 
CP 
JP 
CP 
JR 
CP 
JR 
CP 
JR 
CP 
JR 
CP 
JR 
JP 



OADH 

Z, SAVER 

OBBH 

Z, RENEW 

0A2H 

Z, OPENER 

OCCH 

Z.STPSET 

0C8H 

Z.MEMSET 

0F2H 

Z.INBEEP 

0B2H 

Z.LOWGAS 

OAOH 

Z.BIPOFF 

OAAH 

Z,UPPPER 

OBBH 

Z.MENU 

1997H 



THIS IS THE MENU 



MENU 



LD 

CALL 

LD 

CALL 

LD 

CALL 

LD 

CALL 

JR 



HL.INTR01 
2BA7H 
HL.INTR02 
2BA7H 
HL.INTR03 
2BA7H 
HL.INTR04 
2BA7H 
READYX 

; THIS PUTS LOWER CASE IN PLACE 
LOWCAS LD A,1 

LD {SHIFTRJ.A 

LD HL, LOWER 

LD (401EH),HL 

JR READYX 

i THIS REMOVES LOWER CASE DISPLAY 
UPPPER LD HL,0458H 

LD (401EHJ,HL 

JR READYX 

; THIS REMOVES KBPFIX ROUTINE 
BIPOFF LD HL.D3E3H 

LD (4016H),HL 

JR READYX 





02880 


; THIS 


PUTS KBPFIX IN PUCE 


31F8 218530 


02B9D 


INBEEP 


LD 


HL, KBPFIX 


31FB 221640 


02900 




LD 


i4Q16H},HL 


31FE C3CC06 


02910 


READYX 


JP 


READY 




02920 


; THIS 


IS BEGINNING OF RENEW SEQUENCE 


3201 ED5BA44C 


I 02930 


RENEW 


LD 


DE,(40A4H) 


3205 3EFF 


02940 




LD 


A.OFFH 


3207 12 


02950 




LD 


(DE) ,A 


320B CDFC1A 


02960 




CALL 


1AFCH 


320B 23 


02970 




INC 


HL 


320C 22F940 


02980 




LD 


[40F9HJ ,HL 


320F ED7BEB4C 


! 02990 




LD 


SP,[40E8H) 


3213 C37630 


03000 


FGHIJ 


JP 


RSLVII 




03010 


i THIS 


CHECKS 


NEXT BYTE FOR RUN COMMAND 


3216 CD781D 


0302D 


SAVER 


CALL 


BYTE 


3219 FEDO 


03030 




CP 


ODOH 


321B 20A1 


03040 




JR 


NZ, SYNERR 


321D CD7B1D 


03050 




CALL 


BYTE 


3220 FE8E" 


03060 




CP 


8EH 


3222 C2F433 


03070 




JP 


NZ.MACH 




03080 


; CHECK FOR QUOTATION HARK DELIMITER 


3225 CD7B1D 


03090 




CALL 


BYTE 


322S FE22 


03100 




CP 


022H 


322A 2092 


03110 




JR 


NZ, SYNERR 




03120 


; CHECK TO SEE THAT NAME IS IN PLACE 


322C CD781D 


03130 




CALL 


BYTE 


322F CAA024 


03140 




JP 


Z,24A0H 




03150 


i SAVE 


BASIC 


POINTERS IN STACK 


3232 E5 


031 60 




PUSH 


HL 


3233 F5 


03170 




PUSH 


AF 


3234 D5 


03180 




PUSH 


DE 


3235 C5 


03190 




PUSH 


BC 




03200 


; DEFINE TAPE 


DRIVE 0, TURN ON RECORDER 




03210 


; THEN 


WRITE LEADER AND SYNC BYTE 




03220 


; AND I 


iffllTE MACHINE PROGRAM CODE 55H 


3236 AF 


03230 




XOR 


A 


3237 CD1202 


03240 




CALL 


021 2H 


323A CD8702 


03250 




CALL 


0287H 


3230 3E55 


03260 




LD 


A.55H 


323F CD6402 


03270 




CALL 


WHTBYT 




03280 


; WRITE PROGRAM NAME TO TAPE 


3242 0606 


03290 




LD 


B,06 


3244 2B 


03300 




DEC 


HL 


3245 CD781D 


03310 


NAMES 


CALL 


BYTE 


324B FE22 


03320 




CP 


22H 


324A 2807 


03330 




JR 


Z, NEXTBT 


324C CD6402 


03340 




CALL 


WBTBYT 


324F 10F4 


03350 




DJNZ 


NAMES 


3251 1807 


03360 




JR 


DUMP 




03370 


; FILL 


OUT WITH 20H [ASCII BLANKS) IF NECESSARY 


3253 3E20 


03380 


NEXTBT 


LD 


A,20H 


3255 CD6402 


03390 




CALL 


WRTBYT 


3258 10F9 


03400 




DJNZ 


NEXTBT 




03410 


i DUMP 


FIRST 


TWO PAGES (4000 TO 41 FF] TO TAPE 


325A 210040 


03420 


DUMP 


LD 


HL.SETPTS 


325D CDC032 


03430 




CALL 


OUTSEQ 


3260 CDC032 


03440 




CALL 


OUTSEQ 




03450 


; DUMP 


REST OF POINTERS (42D0 TO 42E9) TO TAPE 


3263 06E9 


03460 




LD 


B,0E9H 


3265 CDC032 


03470 




CALL 


OUTSEQ 




03480 


; FIND 


END OF 


PROGRAM VARIABLES AND ARRAYS 


3268 ED5BFD40 


03480 




LD 


DE.tVAREND] 




03500 


; DUMP 


FIRST ! 


SEGMENT OF PROGRAM TO TAPE 


326C 7B 


03510 




LD 


A,E 


3260 95 


03520 




SUB 


L 


326E 47 


03530 




LD 


B,A 


326F CDC032 


03540 




CALL 


OUTSEQ 




03550 


; DUMP 


PROGRAM TO TAPE PAGE BY PAGE 


3272 7C 


03560 


NXTPGE 


LD 


A,H 


3273 3D 


03570 




DEC 


A 


3274 BA 


03580 




CP 


D 


3275 2805 


03590 




JR 


Z.FINSH1 


3277 CDC032 


03600 




CALL 


OUTSEQ 


3 27 A 1BFB 


03610 




JR 


NXTPGE 




03620 


; FIND BEGINNING OF STRING STORAGE AREA 


327C 2AE840 


03630 I 


FINSH1 


LD 


HL.(STACKR) 




03640 


; FIND 


TOP OF AVAILABLE MEMORY 


327F ED5BB140 


03650 




LD 


DE.IMEMTOP) 




03660 


; DUMP 


FIRST SEGMENT OF STRING-TO-MEMORY END 


3283 13 


03670 




INC 


DE 


3284 7B 


03680 




LD 


A,E 


3285 95 


03690 




SUB 


L 


3286 47 


03700 




LD 


B.A 


3287 CDC032 


03710 




CALL 


OUTSEQ 




03720 


; DUMP 


REMAINDER OF MEMORY PAGE BY PAGE 


32BA 7C 


03730 I 


MXTBCH 


LD 


A,H 


328B 3D 


03740 




DEC 


A 


32BC BA 


03750 




CP 


D 


328D 2805 


03760 




JR 


Z, KEEPIT 


328F CDC032 


03770 




CALL 


OUTSEQ 


3292 18F6 


03780 




JR 


NXTBCH 




03790 


; DUMP 


KEEPIT 


CONTROL BYTES 


3294 2AB140 


03800 I 


<EEPIT 


LD 


HL,(40B1H) 


3297 0610 


03810 




LD 


B.10H 



278 



3E99 CDC032 


03B20 




CALL 


OUTSEQ 




03830 ; 


DUMP I 


COMPLETE VIDEO MEMORY 


328C 21QQ3C 


03840 




LD 


HL, VIDEO 


329F 0604 


03850 




LD 


B,4 


32A1 CS 


03860 CDEF 


PUSH 


BC 


32A2 CDBE32 


03870 




CALL 


PREOUT 


32A5 01 


038B0 




POP 


BC 


32A6 10F9 


03B90 




DJNZ 


CDEF 




03900 ; 


WRITE 


END OF 


PROGRAM CODE (78) 


32A8 3E7B 


03910 




LD 


A.78H 


3EAA CD640E 


03920 




CALL 


WRTBYT 




03830 ; 


WRITE START ADDRESS AFTER LiOAD (06CCH) 


3SAD 3EC0 


03940 




LD 


A.OCCH 


32AF CD64Q2 


03950 




CALL 


WRTBYT 


32B2 3E06 


03960 




LD 


A, 06 


3EB4 CDB402 


03970 




CALL 


WRTBYT 




039B0 ; 


RESTORE BASIC INFORMATION TO REGISTERS 


3EB7 C1 


03990 




POP 


BC 


3SBB D1 


04000 




POP 


DE 


3EB9 F1 


04010 




POP 


AF 


32BA E1 


040 EO 




POP 


HL 




04030 ; 


RETURN TO BASIC PR06RAM IN PROGRESS 


32BB C3CC06 


04040 




JP 


READY 




04050 ; 


OUTPUT SEQUENCE SUBROUTINE 




04060 ; 


WRITE 


BLOCK 


HEADER CODE (3d 


3SBE 0600 


04070 PREOUT 


LD 


B,0 


32C0 3E3C 


04080 OUTSEQ 


LD 


A.3CH 


3ECE CD6402 


04090 




CALL 


WRTBYT 




04100 i 


GET NUMBER OF BYTES TO WRITE 


32C5 78 


04110 




LD 


A,B 


32C6 CD640E 


04120 




CALL 


WRTBYT 




04130 i 


i GET START ADDRESS LSB, SAVE IN C [CHECKSUM) 


32C9 70 


04140 




LD 


A,L 


32CA 4F 


041 50 




LD 


C,A 


32CB CD6402 


041 BO 




CALL 


WRTBYT 




04170 | 


; BET START ADDRESS FEB, SAVE IN C (CHECKSUM) 


32CE 79 


04180 




LD 


A,C 


3SCF B4 


04190 




ADD 


A,H 


3ED0 4F 


04200 




LD 


C,A 


3SD1 7C 


04210 




LD 


A,H 


3202 CD6402 


04220 




CALL 


WRTBYT 




04230 


; GET BLOCK OF 


: DATA, WHITE, AND SAVE IN C 


32D5 79 


04240 I 


KRTPGE 


LD 


A.C 


3206 86 


04250 




ADD 


A,(HL) 


32D7 4F 


04260 




LD 


C,A 


3208 7E 


04270 




LD 


A,(HL) 


3ED9 CD6402 


04280 




CALL 


WRTBYT 


32DC 23 


04290 




INC 


HL 


32DD 10F6 


04300 




DJNZ 


WRTPGE 




04310 


i GET CHECKSUM FROM C AND WRITE TO TAPE 


32DF 79 


04320 




LD 


A,C 


32E0 CD6402 


04330 




CALL 


WRTBYT 


32E3 C9 


04340 




RET 






04350 


i GET REST OF 


DATA AND CONVERT 


32E4 CD7B1D 


04360 


OPENER 


CALL 


BYTE 


32E7 FE22 


04370 




CP 


22H 


32E9 CEBE31 


04380 




JP 


NZ.SYNERR 


32EC E5 


04390 




PUSH 


HL 


32ED CD0133 


04400 




CALL 


XX99 


32F0 CDC901 


04410 




CALL 


01C9H 


32F3 1B4D 


04420 




JR 


NEXT99 




04430 


i GET • 


16 SCREEN POSITIONS READY C10H) 


32F5 7A 


04440 


CONTNT 


LD 


A.D 


32F6 214Q3C 


04450 




LD 


HL,3C40H 


32F9 E6F0 


04460 




AND 


OFOH 


32FB CDBB33 


04470 




CALL 


RRRRS 


3EFE 7A 


044BD 




LD 


A,D 


32FF E60F 


04490 




AND 


OFH 


3301 CDB033 


04500 




CALL 


HEXASC 


3304 77 


04510 




LD 


(HL) ,A 


3305 S3 


04520 




INC 


HL 


3306 7B 


04530 




LD 


A,E 


3307 EBFO 


04540 




AND 


DFOH 


3309 C0BB33 


04550 




CALL 


RRRRS 


330C 7B 


04560 




LD 


A,E 


33 OD E60F 


04570 




AND 


OFH 


33 OF C0B033 


04580 




CALL 


HEXASC 


3312 77 


04590 




LD 


(HL),A 


3313 E1B03G 


04600 




LD 


HL,3C80H 


3316 0610 


04610 




LD 


B,10H 




04620 


; DISPLAY CONTENTS OF ADDRESS CHOSEN 


331B 1A 


04630 


C0NT02 


LD 


A.tDE) 


3319 E6F0 


04640 




AND 


OFOH 


331 B CDBB33 


04650 




CALL 


RRRRS 


331 E 1A - 


04660 




LD 


A.tDE) 


331F E60F 


04670 




AND 


OFH 


3321 CDB033 


046 BO 




CALL 


HEXASC 


3324 77 


04690 




LD 


(HL),A 


3325 23 


04700 




INC 


HL 


3326 23 


04710 




INC 


HL 


3327 13 


04720 




INC 


DE 




04730 


; REDO 


IT 16 


TIMES FOR FULL LINE 


33 2B 10EE 


04740 




DJNZ 


C0NT02 





04750 ; 


DISPL 


AY ASCII 


VALUES TOO 


332A 0610 


04760 




LD 


B.10H 


332C C5 


04770 




PUSH 


BC 


332D 1B 


047BD 




DEC 


DE 


332E 10FD 


04790 




DJNZ 


S-1 


3330 C1 


04800 




POP 


BC 


3331 C5 


04810 




PUSH 


BC 


3332 E1C03C 


04820 




LD 


HL.3CC0H 


3335 1A 


04830 BBBA 


LD 


A.tDE) 


3336 77 


04840 




LD 


(HL) ,A 


3337 23 


04B50 




INC 


HL 


333B 23 


04B60 




INC 


HL 


3339 23 


04870 




INC 


HL 


333A 13 


04BBD 




INC 


DE 


333 B 10FB 


04890 




DJNZ 


BBBA 


3330 C1 


04900 




POP 


BC 


333E 1B 


04910 




DEC 


DE 


333F 10FD 


04920 




DJNZ 


S-1 


3341 C9 


04930 




RET 






04940 ; 


; SCAN 


FOR EDIT / GET THIRD SCREEN LINE 


3342 CDF532 


04950 NEXT99 


CALL 


CONTNT 




04960 ; 


! SCAN 


KEYBOARD 


I FOR BREAK, ARROWS 


3345 3A403B 


04970 I 


EDITOR 


LD 


A,(3840H) 


3348 17 


04980 




RLA 




3349 17 


04990 




RLA 




334A 3003 


05000 




JR 


NC.AAAA 


334C 13 


05D10 




INC 


DE 


334D 1850 


05020 




JR 


STNDRD 


334F 17 


05030 AAAA 


RLA 




3350 3003 


05040 




JR 


NC.AAAB 


3352 1B 


05D5D 




DEC 


DE 


3353 184A 


05D60 




JR 


STNDRD 


3355 0610 


0507D i 


4AAB 


LD 


B.10H 


3357 17 


05080 




RLA 




3358 3005 


05090 




JR 


NC.AAAC 


335A 1B 


05100 




DEC 


DE 


335B 10FD 


05110 




DJNZ 


S-1 


335D 1840 


05120 




JR 


STNDRD 


335F 17 


05130 AAAC 


RLA 




3360 3005 


05140 




JR 


NC, BREEK 


3362 13 


05150 




INC 


DE 


3363 10FD 


051 6D 




DJNZ 


S-1 


3365 1838 


05170 




JR 


STNDRD 


3367 17 


05180 


BREEK 


RLA 




3368 3004 


05190 




JR 


NC.AAAD 


336A E1 


052D0 




POP 


HL 


336B C3CC06 


05E10 




JP 


READY 




05220 


; DISPLAY EDITING / GET FIFTH SCREEN LI 


336E 21D13D 


05230 


AAAD 


LD 


HL.3D01H 


3371 365F 


05240 




LD 


(HL) ,5FH 


3373 2B 


05250 




DEC 


HL 


3374 365F 


05260 




LD 


(HD.5FH 


3376 0602 


05E70 




LD 


B.S 


337B D5 


D5EBQ 


AAAE 


PUSH 


DE 


3379 E5 


05290 




PUSH 


HL 


337A CD4900 


05300 




CALL 


0049H 


337D E1 


05310 




POP 


HL 


337E D1 


053 EO 




POP 


DE 


337F FE47 


05330 




CP 


47H 


3381 30C2 


05340 




JR 


NC, EDITOR 


33B3 FE3D 


05350 




CP 


30H 


33B5 38BE 


OS36Q 




JR 


C, EDITOR 


3387 FE3A 


05370 




CP 


3AH 


3389 3804 


05380 




JR 


C.AAAF 


338B FE40 


05390 




CP 


40H 


3380 38B6 


05400 




JR 


C, EDITOR 


33BF 77 


0541 D 


AAAF 


LD 


(HL),A 


3390 23 


05420 




INC 


HL 


3391 10E5 


05430 




DJNZ 


AAAE 




05440 


J CONVERT CHOSEN DATA TO HEX 


3393 2B 


05450 




DEC 


HL 


3394 CDA733 


05460 




CALL 


ASCHEX 


3397 4F 


05470 




LD 


C,A 


33 SB 28 


05480 




DEC 


HL 


3399 CDC233 


05490 




CALL 


LLLLS 


339C B1 


055D0 




ADD 


A,C 




05510 


; PUT 


NEW BYTE 


IN PLACE 


339D 1E 


055E0 




LD 


(DE).A 


339E 13 


05530 




INC 


DE 




05540 


; DISPLAY REVISED LINE OF DATA 


339F CDF532 


05550 


STNDRD 


l CALL 


CONTNT 


33A2 CDCA33 


05560 




CALL 


DELAY 


33A5 189E 


0557D 




JR 


EDITOR 




055B0 


; ASCII TO HEXADECIMAL CONVERSION 


33A7 7E 


05590 


ASCHEX 


I LD 


A,(HL) 


33A8 D630 


05600 




SUB 


3 OH 


33 AA FEDA 


05610 




CP 


OAH 


33AC D8 


05520 




RET 


C 


33AD D607 


05630 




SUB 


7 


33AF C9 


05640 




RET 






05650 


; HEXADECIMAL TO ASCII CONVERSION 


33BD C630 


05660 


HEXASC 


! ADD 


A.30H 


33 BE FE3A 


05670 




CP 


3AH 



279 



33 B4 DB 


05680 




RET 


C 


33B5 C607 


05690 




ADD 


A, 7 


33 B7 C9 


05700 




RET 






05710 


; RIGHT 


ROTATES 


FOR CONVERSIONS 


33BB OF 


05720 


RRRRS 


RRCA 




33BS OF 


05730 




RRCA 




33 BA OF 


05740 




RRCA 




33BB OF 


05750 




RRCA 




33 BC CDB033 


05760 




CALL 


HEXASC 


33BF 77 


05770 




LD 


(HL) ,A 


33C0 23 


05780 




INC 


HL 


33C1 C9 


05790 




RET 






Q5BQ0 


i LEFT 


ROTATES 


FOR CONVERSION 


33C2 CDA733 


05810 


LLLLS 


CALL 


ASCHEX 


33G5 07 


05820 




RLCA 




33C6 07 


05830 




RLCA 




33G7 07 


05840 




RLCA 




33CB 07 


05850 




RLCA 




33C9 C8 


05860 




RET 






05870 


; DELAY 


FOR SCREEN DISPLAYS 


33CA 010020 


058B0 


DELAY 


LD 


BC,2000H 


33CD CD6000 


05B90 




CALL 


0060H 


3300 CS 


05900 




RET 






05910 


; GET/CONVERT ASCII FROM BUFFER 




05920 


i TO HEXADECIMAL ADDRESS 


33D1 0604 


05930 XX99 


LD 


B,4 


33D3 GD781D 


05940 


SSSS 


CALL 


BYTE 


3306 F5 " 


05950 




PUSH 


AF 


3307 10FA 


05960 




DJNZ 


SSSS 


3309 F1 


05970 




POP 


AF 


33DA 77 


05980 




LD 


(HL) ,A 


33DB CDA733 


059S0 




CALL 


ASCHEX 


33DE SF 


06000 




LD 


E,A 


33DF F1 


06010 




POP 


AF 


33 EO 77 


06020 




LD 


(HL) ,A 


33E1 CDC233 


06030 




CALL 


LLLLS 


33 E4 S3 


06040 




ADD 


A,E 


33 E5 5F 


06050 




LD 


E,A 


33E6 F1 


06060 




POP 


AF 


33 E7 77 


06070 




LD 


(HL),A 


33EB CDA733 


06080 




CALL 


ASCHEX 


33 EB 57 


06090 




LD 


D,A 


33EC F1 


06100 




POP 


AF 


33 ED 77 


06110 




LD 


(HL) ,A 


33EE CDCS33 


06120 




CALL 


LLLLS 


33F1 82 


06130 




ADD 


A.D 


33F2 57 


06140 




LD 


D,A 


33F3 C9 


06150 




RET 






06160 


i RESULT OF ABOVE IN DE REGISTER 




06170 


; CHECK 


FOR "OPEN" COMMAND 


33F4 FEA2 


06180 


MACH 


CP 


0A2H 


33F6 2005 


06190 




JR 


NZ.SYN2 




06200 


; CHECK 


FOR QUOTATION MARK DELIMITER 


33FB CD7B1D 


06210 




CALL 


BYTE 


33FB D622 


06220 




SUB 


22H 


33FD C2BE31 


0623O 


SYN2 


JP 


NZ.SYNERR 




06240 


: TURN 


ON TAPE 


DRIVE, WRITE LEADER 




06250 


; AND SYNC BYTE 


, MACHINE CODE HEADER 


3400 CD1202 


06260 




CALL 


021 2H 


3403 CDB702 


06270 




CALL 


D287H 


3406 3E55 


06280 




LD 


A.55H 


3408 CDB402 


06290 




CALL 


WRTBYT 




06300 


i WRITE 


NAME TO 


TAPE UNTIL 




06310 


i COMMA 


DELIMITER IS FOUND 


340B 0606 


06320 




LD 


B,06 


3400 CD7B1D 


06330 


NAME99 


CALL 


BYTE 


3410 FE2C 


06340 




CP 


2CH 


341 E 2B07 


06350 




JR 


Z.NXTB99 


3414 CD6402 


06360 




CALL 


WRTBYT 


3417 10F4 


06370 




DJNZ 


NAME99 


3419 1807 


06380 




JR 


0UMP39 




06390 


; FILL 


OUT WITH 


BLANKS IN NAME 




06400 


; LESS 


THAN 6 CHARACTERS 


341 B 3E20 


06410 


NXTB99 


LD 


A,20H 


3410 006402 


06420 




CALL 


WRTBYT 


3420 10F9 


06430 




DJNZ 


NXTB99 




06440 


; CHECK 


FOR COMMA DELIMITER 


3422 CD7B1D 


06450 


DUMP99 


CALL 


BYTE 


3425 FE2C 


06460 




CP 


2CH 


3427 2004 


06470 




JR 


NZ.SYN2 




06480 


; GET START ADDRESS AND SAVE 


3429 C0D133 


06490 




CALL 


XX99 


342C D5 


06500 




PUSH 


DE 




06510 


i CHECK 


FOR NEXT COMMA DELIMITER 


342D CD781D 


06520 




CALL 


BYTE 


3430 FE2C- 


06530 




CP 


2CH 


3432 2B05 


06540 




JR 


Z.TTTT 


3434 01 


06550 




POP 


DE 


3435 AF 


06560 




XOR 


A 


3436 C3A024 


06570 




JP 


24A0H 


- 


06580 


; GET END ADDRESS AND SAVE 


3439 CDD133 


065S0 


TTTT 


CALL 


XX99 


343e 05 


06600 




PUSH 


DE 





08610 


i EXECUTION ADDRESS AFTER FINAL COMMA 


343D CD7B1D 


08620 


CALL BYTE 


3440 FE2C 


06630 


CP 2CH 


3442 2808 


08640 


JR Z.EXECU 




06650 


; AUTOEXECUTE 06CC IF NOT SPECIFIED 


3444 21CC06 


06660 


LD HL.06CCH 


3447 227E40 


06670 


LD [407EH],HL 


344A 1807 


06680 


JR WRIT88 




06690 


; GET EXECUTION ADDRESS 


344C CDD133 


06700 


EXECU CALL XX99 


344F ED537E40 06710 


LD (407EH),DE 




06720 


; 16-BIT SUBTRACTION GETS NUMBER OF 




06730 


; BYTES; GET START ADDR. & COMPL'T. 


3453 E1 


06740 


WRIT99 POP HL 


3454 01 


06750 


POP DE 


3455 05 


D676D 


PUSH DE 


3456 7A 


06770 


LD A,D 


3457 2F 


067B0 


CPL 


3458 57 


06790 


LD D,A 


3459 7B 


06800 


LD A,E 


345A 2F 


06810 


CPL 


345B 5F 


06820 


LD E,A 




06 BSD 


; END ADDRESS + COMPL'T = BYTES 




06840 


; ADD 1 FOR SUB, 1 FOR INCLUSIVE 


345C 19 


06850 


ADD HL.DE 


345D 23 


06860 


INC HL 


345E 23 


06870 


INC HL 




06880 


i TRANSFER BYTES TO WRITE TO DE 


345F E5 


06BS0 


PUSH HL 


346D 01 


06900 


POP DE 




06910 


; RESTORE START ADDRESS TO HL 


3461 E1 


06920 


POP HL 


3462 43 


06930 


LD B,E 




06940 


; ZERO E REGISTER, INC D, TO GET 




06950 


; TOTAL NUMBER OF PAGES; SAVE IT 


3463 04 


06960 


INC B 


3464 14 


06970 


INC D 


3485 D5 


069B0 


LP99 PUSH DE 


3488 CDC032 


069S0 


CALL OUTSEO. 




07000 


; CHECK IF ALL PAGES WRITTEN 


3469 D1 


07D10 


POP DE 


348A 15 


07020 


DEC 


346B 20F8 


07030 


JR NZ,LP99 




07040 


; WRITE END OF PROGRAM CODE 


346D 3E78 


070B0 


LD A,7BH 


346F CD6402 


07060 


CALL WRTBYT 




07070 


; WRITE START ADDRESS; 06CC = DEFAULT 


3472 3A7E40 


0708D 


LD A,i407EH) 


3475 CD6402 


07090 


CALL WRTBYT 


3478 3A7F40 


07100 


LD A,(407FH) 


347B CD6402 


07110 


CALL WRTBYT 


- 


07120 


; RETURN TO COMMAND LEVEL 


347E 1B37 


07130 


JR PREP2 


- 


07140 


; START SETUP OF STEPPER ROUTINE 




07150 


; FIRST FIND IF ARGUMENT EXISTS 


3480 F5 


07160 


STPSET PUSH AF 


3481 E5 


07170 


PUSH HL 


3482 CD7B1D 


071 BO 


CALL BYTE 


3485 B7 


07190 


OR A 




07200 


; ARGUMENT EXISTS - JUMP TO ROUTINE 


3486 200C 


07210 


JR NZ.IIII 




07220 


: OTHERWISE JUMP PAST SINGLE STEPPER 


3488 FD360476 


07230 


LD (IY+4),SKPSTPS00FFH 


34BC FD360531 


07240 


LD (IY+5),SKPSTPK0FF00H<-8 


3480 E1 


07250 


POP HL 


3491 F1 


07280 


POP AF 


3492 1823 


0727D 


JR PREPS 




07280 


; GET VALUE FROM A REGISTER INTO D 


3484 0630 


07290 


IIII SUB 30H 


3496 17 


07300 


RLA 


3497 17 


0731 Q 


RLA 


3498 17 


07320 


RLA 


3499 17 


07330 


RLA 


348A 57 


07340 


LD D.A 




07350 


; GET NEXT BUFFER VALUE ELSE SN ERROR 


349B CD781D 


07360 


CALL BYTE 


349E B7 


07370 


OR A 


349F 2005 


07380 


JR NZ.ABCD 


34A1 E1 


07390 


POP HL 


34A2 F1 


07400 


POP AF 


34A3 C3BE31 


07410 ! 


3YN3 JP SYNERR 




07420 


; GET NEXT VALUE FROM BUFFER INTO E 


34A6 0630 


07430 ABCD SUB 30H 


34AB 82 


07440 


ADD A.D 


34A9 57 


07450 


LD D.A 




07460 


; PATCH STEPPER INTO PLACE 


34AA FD3604BA 


0747D 


LD (IY+4) .JMPPOSSOOFFH 


34AE FD360534 


07480 


LD UY+5),JMPPQS&QFF00H<-B 




07490 


; GET DELAY VALUE INTO REGISTER 




07500 


; AND GO OUT TO READY PROMPT 


34B2 FD7206 


07510 


LD (IY+6) ,D 


34B5 E1 


07520 


POP HL 


34B6 F1 


07530 


POP AF 
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34B7 C3CG0B 


07541: PREP2 


JP 


READY 


35A3 2A 




07550 ; 


THIS 


IS THE STEPPER ROUTINE 


35C8 OA 


34BA 


07560 JHPPOS 


EQU 


5 


35CA 2A 


34BA F5 


07570 STEPPR 


PUSH 


AF 


35EF OA 


34BB CS 


075B0 




PUSH 


BC 


35F0 2A 




07 580 ; 


WAIT 


FOR SHIFT TO BE PRESSED 


3614 OA 


34BC 3A8Q3B 


07600 LUPER 


LD 


A,[3880H) 


3615 2A 


34BF A7 


07610 




AND 


A 


3640 OD 


34C0 2BFA 


07620 




JR 


Z, LUPER 


3641 00 




07B30 i 


LOAD 


DELAY VALUE INTO BC 


3642 2A 


34C2 4F 


07640 




LD 


C,A 


366B OA 


34C3 FD46Q6 


07650 




LD 


B, (IY+61 


366C 2A 




07660 i 


! CALL 


DELAY U 


I ROM 


3693 OA 


34G6 CD6Q00 


07670 




CALL 


0060H 


3684 2A 


34C9 C1 


07BBD 




POP 


BC 


36BB OA 


S4CA F1 


07690 




POP 


AF 


36BC 2A 




07700 i 


; BACK 


TO REST 


OF TEST SEQUENCE 


3606 OD 


34CB C37631 


07710 




JP 


BEGIN 


36D7 00 




07720 | 


; BEGIN 


I MEMORY RESET SEQUENCE 


3608 4E 




07730 : 


; CHECK 


. FOR QUOTE MARK DELIMITER 


370A OA 


34BE CD7810 


07740 MEHSET 


CALL 


BYTE 


370B 4E 


34D1 FEES 


07750 




CP 


22H 


3738 OA 


34D3 2DCE 


07760 




JR 


NZ.SYN3 


3738 4E 




07770 i 


; CONVERT *MEM 


OPERAND TO HEX 


3773 OD 


34D5 CDD133 


07780 




CALL 


XXB9 


3774 00 




07790 


i CHECK 


; FOR >4400H MEMORY ADDRESS 


3039 




07800 


I GO TC 


! OM ERROR IF NOT ENOUGH 


00000 TOTAL E 


34D8 210044 


07810 




LD 


HL.4400H 


18637 TEXT A 


34DB AF 


07820 




XOR 


A 




34DC ED52 


07B30 




SBC 


HL,DE 




340E 027 A1 9 


07840 




JP 


NC.197AH 






07850 


; TEST 


FOR MEMORY RESET <FBBBH 






078B0 


; OM ERROR IF TOO MUCH 




34E1 05 


07870 




PUSH 


DE 




34E2 E1 


078B0 




POP 


HL 




34E3 0607 


07B90 




LD 


B,7 




34ES 23 


07900 




INC 


HL 




34E6 10FD 


07910 




DJNZ 


5-1 




34EB 7E 


07920 




LD 


A,(HL) 




34E9 47 


07930 




LD 


B,A 




34EA EF 


07940 




GPL 






34EB 77 


07950 




LD 


(HLJ.A 




34EC BE 


07 960 




CP 


CHL) 




34E0 C27A19 


07970 




JP 


NZ.197AH 




34F0 70 


07 980 




LD 


[HL),B 






07990 


; PUT NEW MEMORY SIZE INTO PLACE 




34F1 ED53B14C 


! 08000 




LD 


(4081K) ,DE 






0901 


; TRANSFER KEEPIT DATA ROW 






08020 


; AND PUT NEW ADDRESS IN IY 




34F5 FDES 


08030 




PUSH 


IY 




34F7 E1 


08040 




POP 


HL 




34FB 13 


0BQ50 




INC 


DE 




34F9 05 


08060 




PUSH 


DE 




34FA FDE1 


08070 




POP 


IY 




34FC 010700 


080BO 




LD 


BC,7 




34FF EDBO 


08090 




LDIR 






3501 FDE5 


08100 




PUSH 


IY 




3503 E1 


08110 




POP 


HL 






08120 


; MAKE FRE(A$) 


MEM SIZE - 50 DECIMAL 




3504 0B32 


08130 




LD 


B.32H 




350B 1B 


08140 


STRING 


DEC 


DE 




3507 10FD 


08150 




DJNZ 


STRING 






081 BO 


; PUT I 


NEW STRING POINTER IN PUCE 




350S ED53A040 08170 




LD 


(40A0H) ,DE 




3500 C3BC30 


08180 




JP 


GRINS 






08190 


; THIS 


IS LOWER CASE DETERMINATION 




3510 F5 


0B200 


LOWER 


PUSH 


AF 




3511 3A1940 


08210 




LD 


A,(SHIFTR] 




3514 FE01 


08220 




CP 


1 




3516 2804 


08230 




JR 


Z.L0WEH1 




351 B F1 


08240 




POP 


AF 




3519 C35804 


08250 




JP 


045BH 




351 C F1 


08260 


L0WER1 


POP 


AF 




3510 DD6E03 


DB270 




LD 


L,(IX+3) 




3520 006604 


08280 




LD 


H,(IX+4) 




3523 DA9A04 


08290 




JP 


C.049AH 




3526 DD7E05 


08300 




LD 


A,(IX+5) 




3529 B7 


08310 




OR 


A 




352A 2801 


0B320 




JR 


Z, GETCHR 




352C 77 


08330 




LD 


(HLJ.A 




3520 79 


08340 


GETCHR 


LD 


A,C 




352E FE20 


08350 




CP 


20H 




3530 DA0605 


08360 




JP 


C0506H 




3533 FE80 


08370 




CP 


BOH 




3535 D2A604 


0B3B0 




JP 


NC,04A6H 




3538 C37D04 


08390 




JP 


047DH 




353B 2A 


08400 


INTR01 


DEFM 


"FIX = SET DEBOUNCE/BEEP/AUTOREPEAT' 


355E OA 


0B410 




DEFB 


OAH 




355F 2A 


08420 




DEFM 


"KILL = RESET TO NORMAL KEYBOARD' 


357F OA 


08430 




DEFB 


OAH 




3580 2A 


08440 




DEFM 


"MEM = RESET MEMORY 


SIZE (NOTE 13 


35A1 00 


08450 




DEFB 


ODH 




35A2 00 


08460 




DEFB 


OOH 





OB470 INTR02 DEFM 

08480 DEFB 

0B490 DEFM 

0B500 DEFB 

08510 DEFM 

08520 DEFB 

0B530 DEFM 

08540 OEFB 

08550 DEFB 
08560 INTR03 DEFM 

0B570 DEFB 

08580 DEFM 

08580 DEFB 

0B60O DEFM 

08610 DEFB 

08620 DEFM 

08630 DEFB 

08640 DEFB 
0B650 INTR04 DEFM 

0B660 DEFB 

08670 DEFM 

0B680 DEFB 

08680 DEFM 

08700 DEFB 

08710 DEFB 

08720 END 



"PRINT = LOWERCASE KEYBOARD/DISPLAY ON 1 

OAH 

"OUT = LOWERCASE KEYBOARD/DISPLAY OFF 1 

OAH 

"NEW = RESTORE PROGRAM VICTIM OF NEW" 

OAH 

"OPEN = HEX/ASCII/GRAPHICS MONITOR (NOTE 1)' 

ODH 

OOH 

"SAVE/RUN = SAVE RUNNING PROGRAM (NOTE 2] ' 

OAH 

"SAVE/OPEN = MEMORY BLOCK SAVE (NOTE 3) ' 

OAH 

"STEPXX = SINGLE STEPPER ON, XX = DELAY' 

OAH 

"STEP = SINGLE STEPPER OFF' 

ODH 

00 

'NOTE 1 . REQUIRES 4-CHARACTER HEX VALUE IN QUOTES. 

OAH 

'NOTE 2. REQUIRES 6-CHARACTER NAME IN QUOTES.' 

OAH 

'NOTE 3. SAME AS ABOVE PLUS HEX START, 

ODH END, OPTIONAL ENTRY' 

OOH 

START 



AAAA 
AAAB 
AAAC 
AAAD 
AAAE 
AAAF 
ABCD 



334F 
3355 
335F 
336E 
337B 
338F 
34A6 



AROUND 300C 
ASCHEX 33A7 
BACKUP 30D3 
BBBA 3335 
BEEEEP 3132 
BEEPER 3163 
BEGIN 3176 
BIPOFF 31 FO 
BLEEEP 31 4F 
BREEK 3367 
BYTE 1D7B 



CDEF 32A1 
CLRMEM 308E 
CNTROL 30FB 
C0NTQ2 331 8 
CONTNT 32F5 
DECA 30C6 
DELAY 33CA 
DUMP 325A 
DUMP99 3422 
EDITOR 3345 
EXECU 344C 
FGHIJ 3213 
FINSH1 327C 
FOUND 30CB 
FREQCY 31 6C 
GETCHR 352D 
GOAWAY 3131 
GRINS 306C 
HEXASC 33BD 
IIII 3494 
INBEEP 31 FB 
INKEYS 4098 
INTR01 353B 
INTR02 35A3 
INTR03 3642 
INTR04 3608 
JMPPOS 34BA 
KBPFIX 3085 
KEEPIT 3284 
KEYPHS 3080 
KPLACE 401A 
KYSCAN 03FB 
LLLLS 33C2 
LOWCAS 31 OB 
LOWER 3510 
L0WER1 351 C 
LP98 3465 
LUPER 34BC 
MACH 33F4 
MEMSET 34CE 
MEMTOP 40B1 
MENU 31 C1 
NAMESS 3400 



02350 02400 03020 03050 0309D 03130 
04360 05940 06210 06330 0B450 06520 
07180 073B0 07740 



05030 05000 

05070 05040 

05130 05090 

05230 05190 

052B0 05430 

05410 053 BO 

07430 07380 

01400 01360 

05590 05460 05810 05890 06080 

01340 01380 

04B30 04890 

01870 

02120 02200 

02260 07710 

02850 02590 

02000 01B90 01920 

05180 05140 

00390 02330 

0331 D 

06620 

03B60 03890 

00980 01000 

01550 01490 

04630 04740 

04440 04950 05550 

01230 01170 

05B80 05560 

03420 0336D 

06450 06380 

04970 05340 05360 05400 05570 

06700 06640 
03000 

03630 035S0 

01270 01090 

021 BO 02180 

08340 0B320 

01860 01520 

00660 081 BO 

05660 04500 

07290 07210 

02890 02540 

00260 01100 

08400 02650 

08470 02670 

08560 026 90 

08650 02710 

07560 07470 074B0 

00790 02990 

038D0 03760 

00B30 00950 

00290 01050 01130 01150 01240 
00270 

05810 05490 06030 06120 

02750 02560 

09200 02770 

08260 0B230 

06880 07030 

07600 07620 

06180 03070 

07740 02520 

00360 03650 

02650 02620 

06330 06370 



01540 01570 01650 01670 01770 
045BD 04680 05760 
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NAMES 


3245 


03310 


03350 




NEXT99 


3342 


04950 


04420 




NEXTBT 3263 


03380 


03330 03400 




NOTRDY 31 7F 


02320 


02290 




NXTB99 341 B 


06410 


06350 06430 




NXTBCH 


32BA 03730 


037BO 




NXTPGE 3272 


03560 


03610 




OKSTAR 


31 BD 


02400 


02370 




OPENER 


32E4 


04360 


02480 




OUTSEQ 32C0 


040BO 


03430 03440 03470 


03540 03600 03710 03770 








03820 06S90 




PQRTFF 


403D 


00280 


02070 




PREOUT 32BE 04070 


03870 




PHEP2 


34B7 


07540 


07130 07270 




READY 


OBCO 


00350 


00770 02910 04040 


05210 07540 


READYX 


31 FE 02910 


02730 02790 02830 


02870 


RECHEK 


3093 


00890 


01120 01220 




RENEW 


3201 


02930 


02460 




RESTRT 


4004 


00310 


00590 00690 




RRRRS 


33BB 


05720 


0447D 04550 04650 




RSLVII 


3076 


00730 


03000 




SAVE 


3193 


02430 






SAVER 


3216 


03020 


02440 




SETPTS 


4000 


00370 


03420 




SHIFTR 


4019 


00300 


00710 01930 01950 


02760 08210 


SKPSTP 


31 76 


02250 


00630 07230 07240 




SSSS 


33D3 


05940 


05960 




STACKR 


40 EB 


00330 


03630 




START 


3039 


00440 


08720 




STEPPR 


34BA 


07570 






STGEND 40A0 


00320 






STNDRD 


339F 


05550 


05020 05060 05120 


05170 


STPSET 


3480 


07160 


02500 




STRING 


3506 


08140 


08150 




STROKE 30AA 


010B0 


00660 




SYN2 


33F0 


06230 


06190 06470 




SYN3 


34A3 


07410 


07760 




SYNERR 


31 BE 


02630 


02410 03040 03110 


04380 06230 07410 


TABLET 3121 


01780 


01720 




THWSTE 30C1 


01200 


01200 




TTTT 


3439 


06590 


06540 




UPPPER 


31 E8 


02810 


02600 




VAREND 


40FD 


00340 


03490 




VIDEO 


3C00 


00400 


03840 




WRIT99 


3453 


06740 


06680 




WRTBYT 


0264 003B0 


03270 03340 033SD 


03920 03950 03970 04090 








04120 04160 04220 


04280 04330 062S0 06360 








06420 07060 07090 


07110 


WRTPGE 32D5 


04240 


04300 




XX99 


3301 


05930 


04400 06490 06590 


06700 07780 


Z0429H 


30FD 


01 560 


01450 




Z0435H 


3109 


01640 


01620 




2043DH 


3111 


01660 


01590 




20443 H 


3117 


01720 


01700 





KEEPIT 3.2 is a 2K utility program created to 
extend the capabilities of Level II BASIC. It was 
originally sold by The Alternate Source in a RAM- 
based format (version 2.1), and has appeared 
variously from Personal Micro Computers, The 
Peripheral People, and Computer Accessory Tech- 
nology. It is still available from C.A.T., and 
(together with the Memory Sidecar) from MSB 
Electronics, Drawer 766, Barre, Vermont 05641. 
However, since it contains many of the software 
drivers and other routines presented in The Custom 
TRS-80, and represents a complete implementa- 
tion of the custom interpreter (Chapter 3), it is 
offered here as a completely revised version in 
source code format. Its current origin is 3000H, 
for use with the Memory Sidecar project presented 
in Chapter 8. 
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74LS00 Vc0 B4 A4 Y4 B3 A3 Y3 

r r r r r r m 




A1 B1 Y1 A2 B2 Y2 GND 



74LS02 



74LS04 



74LS08 



Vcc Y4 B4 A4 Y3 B3 A3 

r r r r 




TD"tir"uninijr etet 

Y1 A1 B1 Y2 A2 B2 GND 



Vco A6 Y6 A5 Y5 A4 Y4 

M HRH1 Fl Fl R 






lU LAI 111 Lil LU m 

A1 Y1 A2 Y2 A3 Y3 GND 



Vcc B4 A4 Y4 B3 A3 Y3 

R Fl R Fl R Fl R 



) 



G- 



5> 



^_S 



Ch 



a 



LJ LU LlJ Lil LU lil Lf 

A1 B1 Y1 A2 B2 Y2 GND 
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"— ™mmmufaih. 




11 121 13 « » 4 ' "nrnr |z| 

A1 B1 A2 B2 C2 Y2 GND 



Y = ABC 



Vco C1 Y1 C3 B3 A3 Y3 74LS11 

\m m r r r 




Vcc A6 Y6 A5 Y5 A4 Y4 

r r^ fi r r r r 



b 









i 

A1 




Hi LJ bJ bJ LI 

A2 Y2 A3 Y3 GND 



74LS14 



Vcc D2 C2 NC B2 A2 Y2 74LS20 

R R R R Pol R R 




i 

A1 



2 

B1 



3 

NC 



i! LJ bJ hi 

C1 D1 Y1 GND 
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74LS27 



Vcc C1 Y1 C3 B3 A3 Y3 




U LI LJ LI LI Id LJ 

A1 B1 AS B2 C2 Y2 GND 



74LS30 



Vcc NC H G NC NC Y 



E 



D- 



1lTT3~M1±I LJ bJ Ld 

A B C D E F GND 



Y = ABCDEFGH 



74LS32 



Vcc B4 A4 Y4 B3 A3 Y3 

^ r r r r r r 




Lii ih hi lU LJ 

A1 B1 Y1 A2 B2 Y2 GND 



74LS74 vc? C ±L 2 ii C ±l 2 p iL 2 ii il 

R R R R R R R 




ILTOjrDj LU LJ L±J hi 

CLR1 D1 CLK1 PRE1 G.1 Q1 GND 



INPUTS 


OUTPUTS 


PR 


CLR CLK 


D 


Q Q 


L 


H X 


X 


H L 


H 


L X 


X 


L H 


L 


L X 


X 


H" H" 


H 


H t 


H 


H L 


H 


H t 


L 


L H 


H 


H L 


X 


QO QO 
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INPUTS 


OUTPUTS 


D G 


Q 5 


L H 


L H 


H H 


H I 


X L 


■Qo Qo 



H = High Level, L = Low Level, X = Don't Care 

Qq = The Level of Q Before the High-to-Low Transition of G 



Q1 02 

rajra 



ENABLE 
02 1-2 GND 03 03 Q4 

pi r pi pt| ra m 




u Ly uj Grnnn 



Q1 



D1 



D2 3-4 Vcc 

ENABLE 



D3 



D4 



Q4 



74LS75 



INPUTS 


OUTPUT 
Y 


A B 


L L 


L 


L H 


H 


H L 


H 


H H 


I 



Y = A©B = AB + AB 



LS90 

BCD COUNT SEQUENCE 
(Sao Note A) 



Vcc B4 A4 Y4 B3 A3 Y3 



r r ra m m 

^^^^^ ! j^ fc'M s' , f . 'i^.Ml?. "' "7 iiili IfiJL'nF Jf^ntTin 



LS90 

RESET/COUNT TRUTH TABLE 




A1 B1 Y1 A2 B2 Y2 GND 



OUTPUT 



Q D Qc Qa Q A 



RESET INPUTS 



R0(1) R0I2I R9(1) R912I 



OUTPUT 



Q D Q c Q B Qa 



L L 
L L 
L L 
COUNT 
COUNT 
COUNT 
COUNT 



INPUT 

A NC Qa Qd GND Ob Oc 

R R R R R Fj _R 



LS90 BIQUINARY (5-2) 
(See Note B) 



COUNT 


OUTPUT 


Qa 


Q D Qc 


Qb 





L 


L I. 


I 


1 


L 


L L 


H 


2 


L 


L H 


I 


3 


I 


L H 


H 


4 


L 


H L 


L 


5 


H 


L L 


L 


6 


H 


L L 


H 


7 


H 


I H 


L 


8 


H 


L H 


H 


9 


H 


H L 


L 



Notes : 

((A) Output Qa is connected to tnput B for 
BCD count. 

(B) Output Qp is connected to input A for 
bi-quinary count. 

(C) Output Qa is connected to input B. 
IDJH « High Level, L = Low Level, X « 

Don't Care. 






v i 


i 
j. 



B R0[1] RO[23 NC Vcc R9[1 ] R9(2) 
INPUT 



LS92 

COUNT SEQUENCE 
(See Note C) 



LS92 

RESET/COUNT TRUTH TABLE 



RESET INPUTS 


OUTPUT 


ROOI R0I2I 


Qd 


O c Qb 


Qa 


H H 


L 


L L 


L 


L X 




COUNT 




X L 




COUNT 





COUNT 


OUTPUT 


Qd 


Qc Qb 


Qa 





L 


L L 


L 


1 


L 


L L 


H 


2 


L 


L H 


L 


3 


L 


L H 


H 


4 


L 


H L 


L 


5 


L 


H L 


H 


6 


H 


L L 


L 


7 


H 


L L 


H 


8 


H 


L H 


L 


9 


H 


L H 


H 


10 


H 


H L 


L 


11 


H 


H L 


H 



INPUT 

A NC Qa Qd GND Qb Qc 

r r r r r m m 



74LS86 



74LS90 



74LS92 



TD Lil LiFEinH^Ll 

B NC NC NC Vcc ROM) R0[2) 
INPUT 
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^4LS125 



^TOTITTl] 



B RQ(1J ROIS) NC Vcc NC NC 
INPUT 



COUNT SEQUENCE 
(See Note C) 



COUNT 


OUTPUT 


Od 


Qc Qb 


0-A 





L 


L U 


L 


1 


L 


L L 


H 


2 


L 


L H 


L 


3 


L 


L H 


H 


4 


L 


H L 


L 


5 


L 


H L 


H 


6 


L 


H H 


L 


7 


L 


H H 


H 


8 


H 


L L 


L 


9 


H 


L L 


H 


10 


H 


L H 


L 


11 


H 


L H 


H 


12 


H 


H L 


L 


13 


H 


H L 


H 


14 


H 


H H 


L 


15 


H 


H H 


H 



LS93 

Notes : 

(A) Output Q^ is connected to input B for 

BCD count. 
(BJ Output Q.q is connected to input A for 

bi-qumary count. 
(C) Output Q/\ is connected to input B 
{D) H = High Level, L = Low Level, X = 

Don't Care. 



INPUTS 



OUTPUTS 




OUTPUTS 



INPUTS 


OUTPUTS 


G1 


G2 


D C 


B 


A 





1 


2 


3 


4 


5 


6 


7 8 


9 


10 


11 


12 


13 


14 


IS 


L 


L 


L L 


L 


L 


L 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


L 


U 


L L 


L 


H 


H 


L 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


L 


L 


L L 


H 


L 


H 


H 


L 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


L 


L 


L L 


H 


H 


H 


H 


H 


L 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


L 


L 


L H 


I 


L 


H 


H 


H 


H 


L 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


L 


I 


L H 


L 


H 


H 


H 


H 


H 


H 


L 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


I 


L 


L H 


H 


L 


H 


H 


H 


H 


H 


H 


L 


H H 


H 


H 


H 


H 


H 


H 


H 


L 


L 


L H 


H 


H 


H 


H 


H 


H 


H 


H 


H 


L H 


H 


H 


H 


H 


H 


H 


H 


L 


L 


H L 


L 


L 


H 


H 


H 


H 


H 


H 


H 


H L 


H 


H 


H 


H 


H 


H 


H 


L 


L 


H L 


L 


H 


H 


H 


H 


H 


H 


H 


H 


H H 


I 


H 


H 


H 


H 


H 


H 


L 


L 


H L 


H 


I 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


L 


H 


H 


H 


H 


H 


L 


L 


H L 


H 


H 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


L 


H 


H 


H 


H 


L 


L 


H H 


L 


L 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


K 


L 


H 


H 


H 


L 


L 


H H 


L 


H 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


L 


H 


H 


L 


L 


H H 


H 


L 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


I 


H 


L 


L 


H H 


H 


H 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


I 


L 


H 


X X 


X 


X 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H" 


H 


I 


X X 


X 


X 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 


H 


H 


X X 


X 


X 


H 


H 


H 


H 


H 


H 


H 


H H 


H 


H 


H 


H 


H 


H 


H 



H = High Level, L = Low Level. X = Don't Care 
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INPUTS 


OUTPUT 
Y 


A C 


H L 
L L 
X H 


H 

L 

Hi-Z 



Vcc C4 A4 Y4 C3 A3 Y3 

ra r ra nn ra 171 n 




ID Lij lAj LiJ LU LJ Ld 

C1 A1 Y1 C2 AS Y2 GND 



74LS125 



74LS154 



INPUTS 


OUTPUT Y 


STROBE 


SELECT 


A 


B 


157, L157A 
LS157, S157 


LS158 
S1S8 


H 


X 


X 


X 


L 


H 


L 


L 


L 


X 


L 


H 


L 


L 


H 


X 


H 


L 


L 


H 


X 


L 


L 


H 


L 


H 


X 


H 


H 


L 



H = High Level.. L = Low Level. X = Don't Care 



INPUTS 



INPUTS 



STROBE, 
Vcc G A4 



OUTPUT 
Y3 



FIF]RRF1F1RFI 



IJJT^^ 



S A1 B1 

SELECT^ y J 

INPUTS 



Y1 A2 B2 Y2 GND 

OUTPUT ^ y ' OUTPUT 

INPUTS 



74LS157 



INPUTS 


INTERNAL 
OUTPUTS 


OUTPUT 


CLEAR 


SHIFT/ 
LOAD 


CLOCK 
INHIBIT 


CLOCK 


SERIAL 


PARALLEL 


A...H 


Q A Q B 


L 
H 
H 
H 
H 
H 


X 
X 
L 
H 
H 
X 


X 
L 

L 
L 
L 
H 


X 

L 

1 
! 
I 


X 
X 
X 
H 
L 
X 


X 
X 
a . . .h 
X 
X 
X 


L L 

Qao Qbo 
a b 
H Qa„ 
L Qa„ 

Qao Qbo 


L 

Qho 
h 

Q Gn 
Q Gn 
Qho 



H = High Level (steady state), L = Low Level (steady state) 

X = Don't Care (any input, including transitions) 

f = Transition from low to high level 

a . , . h = The level of steady-state input at inputs A through H, respectively. 

Q A0. Q B0- Q HO = Tne ievel of Q A- Pb or Q H. respectively, before the indicated 

steady-state input conditions were established. 

^An- ^Gn = "The ievel of Q^ or Qq, respectively, before the most recent t transition 

of the clock 



PAR PARALLEL 

SHIFT/ INP OUTPUT INP.UTS 
Vcc LOAD H Qh 



74LS166 



G F IP CLEAR 

ra fi fi m ra m 




SERIAL A 
INPUT V 



CLOCK CLOCK 
INHIBIT 



PARALLEL INPUTS 
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74LS174 



Vcc 06 DB D5 Q5 D4 Q4 CLOCK 




0#e> 



< 0*0 > 



ro> 



*«> 



LULlILlILUlJLJLlJLlJLL] 

CLEAR 01 D1 D2 02 D3 03 GND 



INPUTS 


OUTPUTS 


CLEAR 


CLOCK 


D 


Q Q* 


L 


X 


X 


L H 


H 


t 


H 


H L 


H 


t 


L 


L H 


H 


L 


X 


Qo Qo 



H ~ High Level (steady state) 

L = Low Level (steady statei 

X = Don't Care 

f - Transition from low to high level 

Qq ~ The level of Q before the indicated steady-state input 

conditions were established. 
t = 175, LS175, and S175 only 



74LS260 



Vcc E1 D1 E2 D2 C2 B2 

R R R R R Fl R 




ID hi LzTTiTTa L±J LJ" 

A1 B1 C1 A2 Y1 Y2 GND 



Y = A+B+C+D+E 



Vcc G2 A6 Y6 A5 Y5 A4 Y4 



y w y 



)£>r 



I B> 



Pi Pn h 



una LiJ LU LU L±J Ld bJ 

G1 A1 Y1 A2 Y2 A3 Y3 GND 



INPUTS 


OUTPUT 
Y 


G1 G2 A 


H X X 
X H X 
L L H 
L L L 


Z 

z 

H 
L 
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INPUTS 


OUTPUT 
Y 


G1 G2 A 


H X X 
X H X 

L L H 
L L L 


Z 

z 

L 
H 



Vcc G2 AB Y6 A5 Y5 A4 Y4_ 74LS366 

^ ra ra r ra fi r 



yy 




rt>i ripn 




LJlljlllLyuJLUujiii 

G1 A1 Y1 A2 YS A3 Y3 GND 



INPUTS 


OUTPUT 

Y 


5 A 


H X 

L H 

L L 


Z 

H 
L 



Vcc G2 A6 Y6 A5 Y5 A4 Y4 




G1 A1 Y1 A2 Y2 A3 Y3 GND 



74LS367 



INPUTS 


OUTPUT 
Y 


G A 


H X 

I H 

L L 


Z 
L 
H 
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Vcc S2 AB Y6 A5 Y5 A4 Y4 74LS368 



) 






_5__f T 





s 



Q^TEri^rilJ L±J ' LLi"" LfJ 

G1 A1 Y1 A2 Y2 A3 Y3 GND 



74LS373 



Vcc QB 



as CLOCK 



si ra isi ra m 




OUTPUT 01 
CTRL A 



EJ Id bJ hJ 



OUTPUT 
CONTROL 


CLOCK 


D 


OUTPUT 


L 
I 
L 
H 


H 
H 
L 
X 


H 
L 
X 
X 


H 
L 
QO 

Z 



74LS374 



ELFLSJF 



D6 D5 Q5 CLOCK 

"l pH f™\ |""1 




CTWETmH 



OUTPUT 0.1 D1 C2 02 03 D3 D4 Q4 GND 
CTRL A 



OUTPUT 
CONTROL 


CLOCK 





OUTPUT 


L 
L 
L 
H 


t 
t 
L 
X 


H 
L 
X 
X 


H 
L 
00 

z 



80C96 




A1 



Y1 



QbJlQlE 



INPUTS 


OUTPUT 


G1 GZ A 


Y 


H X X 
X H X 

L L H 
L L L 


Hi-Z 
HiZ 

L 

H 



A2 



Y2 



A3 



Y3 



GND 
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j INPUTS 


OUTPUT 


j G A 


Y 


H X 
L H 

1 L L 


HiZ 
L 
H 



INPUTS 


OUTPUT 
V 


G1 G2 A 


H X X 
X H X 
L L H 
L L L 


z 

z 

H 

L 



Vcc G2 A6 YB A5 Y5 A4 Y4 

pn fi pn r 




lj lLi LJ m ljJ lu lu m 

G1 A1 Y1 AH Y2 A3 Y3 GND 



Vcc G2 A8 YB A7 Y7 A6 Y6 A5 Y5 

r r r fi r H ra ra ra r^ 




)£> 



i 1 1 i 




fc4 



A V 



hZJH 



LJ LJ LJ LJ LJ L 




G1 A1 Y1 A2 Y2 A3 Y3 A4 Y4 GND 



INPUTS 


OUTPUT 
Y 


G1 G2 A 


H X X 
X H X 

L L H 
L L L 


Z 
Z 

L 
H 




81LS96 



61 A1 Y1 A2 Y2 A3 Y3 A4 Y4 GND 
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V BB |-5V| C 

cs c 
ffE C 

a r. 
*i :: 

DALO C 

SalT l" 

oaO c 

DAL3 C 

Sal j r 

DALl C 

DATE Z 

oaTT c 

phT/step C 

3 h5'Dirc C 

PH3 C 

3PM C 

MR C 

(GND)V SS C 



.19 p 

38 

37 

36p 

35 

34 

33 



30 p 

28 

« n 



23 3 
22 H 



D v D0 i- 12V) 

IMBQ 
3 DRQ 
'.I fjiNT 

WPRT 

-] ip 

^ TROO 

:i WF 

READY 
"] WD 

WG 
3 TG43 
J HLD 

FDDATA 

FDCLK 

<TDS 
3 CLK 

HLT 

TESf 
"] V C I -5V) 



pm COMWECTOOWS 



kC 



COMPUTER 
INTERFACE 



X 



wE 




FLOPPY DISK 

CONTROLLER. 

FORMATTER 



SS Y BB V DD V CC 
1 I I I 



WF" 



TROO 



"1 



ONE SHOT 
(IF USEDI 



FLOPPY 

DISK 

DRIVE 



FD1771 SYSTEM BLOCK DIAGRAM 







INTERNAL DATA 




SEPARATION EDO 1C 




MUST BE T.FDMIU'' 




H h 


'„ 


h H h' Div, H h'™" 


R 




R R R 








_,*,*_ 


Wa 


V 

LEADING EDGE Of 
DATA PULSE 
MUST OCCUR IN 
SHADEO AREA 


NOTE . 






INT ERNAL.DAT A 


SEPARATION MAVWORK fQfi SOM£.(W>PLSCATlONS HOWEVER 


FOR APPLICATIONS REQUIRING HIGH DATA RECOVER'' RELSABiLiTy 


WDC RECOMMENDS EXTERNAL DATA SEPARATION BE USED 



— { ' CYC j— 




J^ 



DIR 5TP SIP ' oiR ' STP 

K -I I 1 h K H I 1 



READ TIMING (XTDS = 1) 



MISCELLANEOUS TIMING 
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PIN OUTS 



Pin No. 


Pin Name 


Symbol 


Function 


1 


Power Supplies 


V BB /NC 


-5V 


19 


MASTER RESET 


MTi 


A logic low on this input resets the device and loads 
"03" into the command register. The Not Ready 
(Status bit 7) is reset during MR ACTIVE. When M~R 
is brought to a logic high, a Restore Command is 
executed, regardless of the state of the Ready signal 
from the drive. 


20 




v S s 


Ground 


21 




v C c 


+5V 


40 




V DD 


+12V 


Computer I 

2 


nterface 


WE 


A logic low on this input gates data on the DAL into 


WRITE ENABLE 


3 




CS 


the selected register when CS is low. 

A logic low on thisinput selects thechipand enables 


CHIP SELECT 


4 




RE 


computer communication with the device. 

A logic low on this input controls the placement of 


READ ENABLE 








data from a selected register on the DAL when CS is 
low. 


5,6 


REGISTER SELECT 


Ao, At 


These inputs select the register to receive/transfer 




LINES 




data on the DAL lines under RE and WE control: 

Ai Ao RE WE 

Status Register Command Register 

1 Track Register Track Register 

1 Sector Register Sector Register 


7-14 






1 1 Data Register Data Register 
Eight bit inverted bidirectional bus used for transfer 


DATA ACCESS LINES 


DAL0-DAL7 








of data, control, and status. This bus is a receiver 








enabled by WE or a transmitter enabled by RE. 


24 


CLOCK 


CLK 


This input requiresafree-running2MHz±1%square 
wave clock for internal timing reference. 


38 


DATA REQUEST 


DRQ 


This open drain output indicates that the DR con- 
tains assembled data in Read operations, or the DR 
is empty in Write operations. This signal is reset 
when serviced by the computer through reading or 
loading the DR in Read or Write operation, respec- 
tively. Use 10K pull-up resistor to +5. 


39 


INTERRUPT REQUEST 


INTRQ 


This open drain output is set at the completion or 
termination of any operation and is reset when a 
new command is loaded into the command register. 
Use 10K pull-up resistor to +5. 


Floppy Disl 


( Interface: 






15 


Phase 1/Step 


PHI/STEP 


If the 3PM input is a logic low the three-phase motor 
control is selected and PH1, PH2, and PH3 outputs 
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Pin No. 


Pin Name 


Symbol 


Function 


16 




PH2/DIRC 


formaoneactivelowsignaloutofthree. PH1 isactive 


Phase 2/Direction 








low after MR. If the 3PM input is a logic high the step 


17 


Phase 3 


PH3 


and direction motor control is selected. The step 


18 




3PM 


output contains a 4 usee high signal for each step 
and the direction output is active high when stepping 


3-Phase Motor Select 


22 






in; active low when stepping out. 

This input is used for testing purposes only and 


TEST 


TEST 








should be tied to +5V or left open by the user. 


23 


HEAD LOAD TIMING 


HLT 


The HLT input is sampled after 10 ms. When a logic 
high is sampled on the HLT input the head is assumed 


25 






to be engaged. 

A logic low on this input selects external data 


EXTERNAL DATA 


XTDS 




SEPARATION 




separation. A logic high or open selects the internal 
data separator. 


26 


FLOPPY DISK CLOCK 


FDCLOCK 


This input receives the externally separated clock 




(External Separation) 




when XTDS = 0. If XTDS = 1 , this input should be tied 


27 


FLOPPY DISK DATA 


FDDATA 


to a iogic high. 


This input receives the raw read disk data if XTDS=1 , 








or the externally separated data if XTDS=0. 


28 


HEAD LOAD 


HLD 


The HLD output controls the loading of the Read- 
Write head against the media. 


29 


Track Greater than 43 


TG43 


This output informs the drive that the Read-Write 
head is positioned between tracks44-76. This output 
is valid only during Read and Write commands. 


30 


WRITE GATE 


WG 


This output is made valid when writing is to be per- 
formed on the diskette. 


31 


WRITE DATA 


WD 


This output contains both clock and data bits of 
500 ns duration. 


32 


Ready 


READY 


This input indicates disk readiness and is sampled 
for a logic high before Read or Write commands are 
performed. If Ready is low, the Read or Write oper- 
ation is not performed and an interrupt is generated. 
A Seek operation is performed regardless of the state 
of Ready, The Ready input appears in inverted format 


33 




WF 


as Status Register bit 7. 

This input detects wiring faults indications from the 


WRITE FAULT 








drive. When WG=1 and WF goes low, the current 








Write command is terminated and the Write Fault 








status bit is set. The WF input should be made inactive 


34 






(high) when WG becomes inactive. 

This input informs the FD1771 that the Read-Write 


TRACK 00 


TR00 


35 




IP" 


head is positioned over Track 00 when a logic low. 
Input, when low for a minimum of 10 usee, informs 


INDEX PULSE 








the FD1771 when an index mark is encountered on 


36 






the diskette. 

This input is sampled whenever a Write command is 


WRITE PROTECT 


WPRT 








received. A logic low terminates the command'and 


37 






sets the Write Protect status bit. 

The iput is sampled whenever a Write Track com- 


DISK INITIALIZATION 


DINT 








mand is received. If DINT=0, the operation is termin- 








ated and the Write Protect status bit is set. 
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COMMAND DESCRIPTION 

The FD1771 will accept and execute eleven com- 
mands. Command words should only be loaded in 
the Command Register when the Busy status bit is 
off (status bit 0). The one exception is'the Force 
Interrupt command. Whenever a command is being 
executed, the Busy status bit is set. When a com- 
mand is completed, an interrupt is generated and the 
Busy status bit is reset. The Status Register indicates 
whether the completed command encountered an 
error or was fault-free. For ease of discussion, com- 
mands are divided into four types. Commands and 
types are summarized in Table 2. 

TYPE 1 COMMANDS 

The Type 1 Commands include the RESTORE, 
SEEK, STEP, STEP-IN, and STEP-OUT commands. 
Each of the Type 1 Commands contain a rate field 
(rori '), which determines the stepping motor rate as 
defined in Table 1, page 4. 

The Type 1 Commands contain a head load flag (h) 
which determines if the head is to be loaded at the 

Table 2. COMMAND SUMMARY 



Table 4. FLAG SUMMARY 





BITS 


TYPE 


COMMAND 


7 


6 


5 


4 3 2 10 




Restore 











h V r-, ro 




Seek 











1 h V ri r 




Step 








1 


u h V ri r 




Step In 





1 





u h V ri ro 




Step Out 





1 


1 


u h V n ro 


II 


Read Command 


1 








110 


II 


Write Command 


1 





1 


1 1 a 


III 


Read Address 


1 


1 





E 


III 


Read Track 


1 


1 


1 


10S 


III 


Write Track 


1 


1 


1 


10 10 


IV 


Force Interrrupt 


1 


1 





1 l 3 la li '4 



Note: Bits shown in TRUE form. 

Table 3. FLAG SUMMARY 



TYPE 



h = Head Load flag (Bit 3) 

h = 1, Load head at beginning 

h = 0, Do not load head at beginning 

V = Verify flag (Bit 2) 

V = 1 , Verify on last track 

V = 0, No verify 

rirn = Stepping motor rate (Bits 1-0) 
Refer to Table 1 for rate summary 
u = Update flag (Bit 4) 

u = 1. Update Track register 

u = 0, No update 



TYPE II 



m = Multiple Record flag (Bit 4) 

m=0, Single Record 
m=1, Multiple Records 

b = Block length flag (Bit 3) 

b=1, IBM format (128 to 1024 bytes) 
b=0, Non-IBM format (16 to 4096 bytes) 

a -|a = Data Address Mark (Bits 1-0) 

a-|ao= 00, FB (Data Mark) 
a-|ao= 01, FA (User defined) 
a-iacr 10, F9 (User defined) 
aia = 11, F8 (Deleted Data Mark) 



Table 5. FLAG SUMMARY 



TYPE III 


s = 


Synchronize flag (Bit 0) 


s=0 

s=1 


Synchronize to AM 

Do Not Synchronize to AM 


TYPE IV 


' li = 

I =1. 
h=1. 
12=1. 

E = 


Interrupt Condition flags (Bits 3-0) 

Not Ready to Ready Transition 
Ready to Not Ready Transition 
Index Pulse 
Immediate interrupt 

Enable HLD and 10 msec Delay 


E=1. 
E=0, 


Enable HLD. HLT and 10 msec Delay 
Head is assumed Engaged and there is 
no 10 msec Delay 



beginning of the command. Ifh=1, the head is 
loaded at the beginning of the command (HLD 
output is made active). If h=0, HLD is deactivated. 
Once the head is loaded, the head will remain 
engaged until the FD1 771 receives a command that 
specifically disengages the head. If the FD1771 
does not receive any commands after two 
revolutions of the disk, the head will be auto- 
matically disengaged (HLD made inactive). The 
Head Load Timing Input is sampled after a 10 ms 
delay, when reading or writing on the disk is to 
occur. 

The Type 1 Commands also contain a verification 
(V) flag which determines if a verification operation 
is to take place on the destination track. If V=1 , a veri- 
fication is performed; if V=0. no verification is 
performed. 

During verification, the head is loaded and after an 
internal 10 ms delay, the HLT input is sampled. When 
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ELECTRICAL CHARACTERISTICS 

Maxium Ratings 

VqD with respect to Vbb (Ground) +20 to -0.3V 
Max Voltage to any input with +20 to -0.3V 

respect to Vbb 
Operating Temperature 0° C to 70° C 

Storage Temperature -55°C to +125°C 



OPERATING CHARACTERISTICS (DC) 

T A = 0°C to 70°C. VdD = +12.0V + .6V, 

V B B = -5-0 ± .5V, V S S = 0V. VCC = +5V + .25V 

I dd = 1 ma Nominal, IcC = 30 ma Nominal, 

I bb = 0.4 Ma Nominal 



Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


ILI 


Input Leakage 






10 


MA 


V|N = VDD 


lLO 


Output Leakage 






10 


ma 


V0UT =v DD 


V|H 


Input High Voltage 


2.6 






V 




V|L 


Input Low Voltage (All Inputs) 






0.8 


V 




VOH 


Output High Voltage 


2.8 






V 


IO = -100uA 


VOL 


Output Low Voltage 






0.45" 


V 


10 = 1.0mA % 



•Write Gate Vql < 0.5V. 



TIMING CHARACTERISTICS 

TA = 0°C to 70° C, V DD = +12V ± .6V, 

V BB = -5V ± .25V, V ss = 0V, V cc = +5V ± .25V 



NOTE: Timings are given for 2 MHz Clock. Forthose 
timings noted, values will double when chip is oper- 
ated at 1 MHz. Use 1 MHz when using mini-floppy. 



Read Operations 












Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TSET 


Setup ADDR and CS to RE 


100 






nsec 




THLD 


Hold ADDR and CS from RE 


10 






nsec • 




TRE 


RE Pulse Width 


500 






nsec 


C L = 25pf 


TDRR 


DRQ Reset from RE 






500 


nsec 




TIRR 


INTRQ Reset from RE 






3000 


nsec 




TDACC 


Data Access from RE 






450 


nsec 


C L = 25 pf 


TDOH 


Data Hold from RE 


50 




150 


nsec 


C L = 25 pf 



Write Operations 












Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TSET 


Setup ADDR and CS to WE 


100 






nsec 


_: 


THLD 


Hold ADDR and CS from WE 


10 






nsec 


' ,,■ ,'.,: 


TWE 


WE Pulse Width 


350 






nsec 




TDRR 


DRQ Reset from WE" 






500 


nsec 




TIRR 


INTRQ Reset from WE 






3000 


nsec 


See Note •; 


TDS 


Data Setup to Wl 


250 






nsec 




TDH 


Data Hold from WE 


150 






nsec 


.'. •■":"''*$■< 



External Data Separation (XTDS = 0) 



Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TPWX 


Pulse Width Read Data & Hock 


150 




350 


nsec 




TCX 


Clock Cycle External 


2500 






nsec 




TDEX 


Data to Clock 


500 






nsec 




TDDX 


Data to Data Cycle 


2500 






nsec 


; 
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DATA VAUO (5X1) 

HEAD DATA 

(BUFFERS TRt-STATEDl 

NOTE: 
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2. FOR READ TRACK COMMAND 
3 - Wviea WORST CASEZSfiSEC 
'TIME DOUaLES WHEN CLK = 1 


1 DACC T 

DOH 

ED LOW IF DESIRED 
THIS TIME MAY BE IT TO 31' USEC WHEN S > 

MHZ 



.- u 



—I I- 



NOTE 

1 CS MAY BE PERMANENTLY TiEO LOW IF OESiRED 

2 WHEN WRITING DATA INTO THiS SECTOR. TRACK. OR DATA REGISTER USER CANNOT 

READ THIS REGISTER UNTIL AT LEAST 8 flSEC AFTER THE RISING EDGE OF wl WHEN 
WRITING INTO THE COMMANO REGISTER. STATUS IS NOT VALIO UNTIL SOME 20uSEC 
LATER THESE TIMES ARE DOUBLED WHEN CLK = ! MHZ 

3 'jBfYiCB WonsTCASE! *f iSEC 

■ = TIME DOU8LE5 WHEN CLK - I MHZ 



READ ENABLE TIMING 



WRITE ENABLE TIMING 



SEPARATION 



h — 






_TL_ 






-"* ^— t pwx — j p— - T 



NOTE 

( ABOVE TIMES ARE DOUBLED WHEN CLK -■ I MHZ 

3 CONTACT WOC FOR EXTERNAL CLOCK/DATA SEPARATOR CIRCUITS 

3 FDCLK AND FDOATA MAY BE REVERSED FOI77S DECIDES WHAT IS CLOCK AND V\ 



J~L 



<H 



Internal Data Separation (XTDS = 1) 



READ TIMING (XTDS = 0) 



Symbol 


Characteristic j Min. 


Typ. 


Max. 


Units 


Conditions 


TPWI 
TCI 


Pulse Width Data and Clock 
Clock Cycle Internal 


150 
3500 




1000 
5000 


nsec 
nsec 





Write Data 


Timing 












Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TWGD 


Write Gate to Data 




1200 




nsec 


300 nsec ± CLK tolerance 


TPWW 


Pulse Width Write Data 


500 




600 


nsec 




TCDW 


Clock to Data 




2000 




nsec 


± CLK tolerance 


TCW 


Clock Cycle Write 




4000 




nsec 


± CLK tolerance 


TWGH 


Write Gate Hold to Data 







100 


nsec 





Miscellaeous Timing 



Symbol 


Characteristic 


Min. 


Typ. 


Max. 


Units 


Conditions 


TCD-i 


Clock Duty 


175 






nsec 


2 MHz ±1% See Note 


TCD 2 


Clock Duty 


210 






nsec 




TSTP 


Step Pulse Output 


3800 




4200 


nsec 


X 


TDIR 


Direct Setup to Step 


24 






usee 




TMR 


Master Reset Pulse Width 


10 






usee 


■ These times doubled 


TIP 


Index Pulse Width 


10 






usee 


when CLK = 1 MHz 


' TWF 


Write Fault Pulse Width 


10 






usee 


". ■ ' ' . ■: : ■".'.;■ 
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Mode Definition Summary Table 


Port 
Bits 


ModeO 


Mode 1 


Mode 2 


IN 


OUT 


IN 


OUT 


Group A Oniv 


PA 


IN 


OUT 


IN 


OUT 


Bidirectronal 


PA, 


IN 


OUT 


IN 


OUT 


i 


PA 2 


IN 


OUT 


IN 


OUT 






PA 3 


IN 


OUT 


IN 


OUT 






PA 4 


IN 


OUT 


IN 


OUT 






PA 5 


IN 


OUT 


IN 


OUT 






PA 6 


IN 


OUT 


IN 


OUT 


Bidirectional 


PA, 


IN 


OUT 


IN 


OUT 


PB 


IN 


OUT 


IN 


OUT 




PB, 


IN 


OUT 


IN 


OUT 




PB 2 


IN 


OUT 


IN 


OUT 




PB 3 
PB 4 


IN 
IN 


OUT 
OUT 


IN 
IN 


OUT 

OUT 


(Mode or Mode 1 only) 


PB 5 


IN 


OUT 


IN 


OUT 




PB 6 


IN 


OUT 


IN 


OUT 




PB, 


IN 


OUT 


IN 


OUT 




PC 


IN 


OUT 


INTR B 


INTR B 


I/O 


PC, 


IN 


OUT 


IBF B 


OBF B 


I/O 


PC 2 


IN 


OUT 


sTI B 


ACK B 


I/O 


pc 3 


IN 


OUT 


INTR A 


INTR A 


INTR A 


PC 4 


IN 


OUT 


STB A 


I/O 


STB A 


PC 5 


IN 


OUT 


IBF A 


I/O 


IBF A 


PC 6 


IN 


OUT 


I/O 


ACK A 


ACK A 


PC, 


IN 


OUT 


I/O 


0B? A 


OBF A 


Physical Dimensions 




















m 


..i 


) 




:,-■- 














piSS. - s .-, 


j? 




b 8 ^ 


• i iWyYWYWWYYWWW 


„ »~ "" 'Z - - 


•.-..•- 


p.as-V 


4J, j - 


-A ' ' ^HKKWWMWWK^iMWKiW} 


! ( 






+;;:=. \fmTmTiwuflTm 


is 


Ceramic Dual-in-Llne Package [Cerdlp (J) 
Order Number INSB255J 


) 


Plastic Dual-in-Line Package (N) 
Order Number INS8255N 


MM 

NMlKmil S*rr*con0ucl» N*Uor.« B.mi™nauao. On«,H NS InlerrurlioruU 
CorporiUon Ei!enheimerilra!5e6lrl1 Miyake Burlfling 
2900 Scrmconduelor Dm-o 5O00 Monchen 21 !-9 yolluya Sn 
Sams Clara. CA 9505! Wei! Germany Tokyo Japan 
Tel («8|737-S0O0 Tel (039!576O9! Trrl (03(355-37 
TW* {9101333-92*0 Tele. 05-227?; TWX 232-2015 


Inc. Japan NaUonal SmtilconOudor NS Eleelrenha Do e«nll SHS EleeWonto Pty. Ltd. 

(Hong Kono, Ltd. Avda Bi>gsOciio Farta Uma B4J Cnr SruH (W 5 Mm HigHway 

niuku-ku tK> flir,F, 00 r 11 AnawConiunio )!<M aawwalet-. V.e,onii3.53 
Cncursg Kong Etccfromc EBdg Jatd.m p ai ,i,nano Austrai.a 
4 Ming Y.p Slrce! Sao Paulo. BraW Tel 03-72S-SJ33 

JSCJ— J Kwun Tong Term H21003 Cabmc Sao PauiD Tclei 33396 




Tol 3-E99235 

Ielf> 43066 NSEHK MX 

CaWc NATSEMP 


""" «° "» >»»™ «"' r»B«n„.l„ lor „» 01 an, „c»«„ OrsenOM „o t, 







300 

































1 

1 1 










i ^ 
























! ) ^ 






< x 


\ 












I 








n 


\ 








"^ 




V. 


<£ 




1 




' 






5 


1 

1 






J 




J „ 


t 








r* 






.■ 


J I 












! T 5* 
I 1 <s 






1 


X " 






— — * * ■ 












rr 


" T 






LL_ * 




p^ 










^ 
















Vt 


N 






--*■¥ 






s 




1 


i 






r 






1 p-^I 




V A 


^ 








5 




s 






TO 

C 

o 
u 












^L 




i 




i <i 










^ 




CO 




















i 










f < 








! ® 


,2 










o 










1 


CD 

> 

5 










1 

e 

55 


u 






Is E = 


I i 

si |S S 


? 


i li 1 II 1 *" 1 a 


E 


5 1 '1 


h- 


















: 


L 
















S L 


>C | 






fTP 


















* \ 
















/~^ ! 


















: 




A 




T ^] ! 








>»r 


s 




I 


>r 










I | 






t 




















1 L ! 






vj 1 


1 








H ' 
















^ly- 








r 












* .. 


. 














rh 




r^i f 










V. i 


-jJ-j 










^^ 




■^ 




l 




1. 

^S t 




3 

I 


r~i 


S 


5 




. vr — 

ijt 


s, 


£ 


40 


























> 
5 








1 3 

£ 






n 






3 

t 
o 
.« 

1 


-^ 


to 


c 


S l ? a == g * = - 1 ° lK " S " !l J 


E 


1 1 is 1 


K 





301 




03 

a 

3 

2 

a 


t: i 

o o 
£ -J 


3 
a. 

O 


3 
a. 


H 
3 

a 

H 
3 
O 


H 

3 
a. 

Z 


3 
CL 
H 
3 
O 


3 
a. 
Z 


3 

Q. 

i- 
3 
O 


3 
a. 

Z 


t- 

3 
a, 
H 
3 
O 


H 
3 
a. 

Z 


H 
3 
a. 
h- 

3 
O 


1- 

3 

CL 

z 


3 

CL 
h- 

3 
O 


h- 

3 

CL 

Z 


3 

a. 
H 
3 
O 


3 
a. 
Z 


ca 

O 

a 


3 

3 
O 


3 
a. 
h- 
3 
O 


t- 
3 
a. 
2 


3 

0. 

Z 


3 

CL 

h- 
3 
O 


3 

1- 
3 

o 


H 
3 
a. 
Z 


3 
a. 
Z 


f- 
3 
a. 
t- 

3 
O 


f- 
3 
a. 
1- 
3 
O 


3 
a. 
Z 


h- 

3 

CL 

z 


t- 
3 
a. 
h- 

3 

o 


h- 

3 

CL 

1- 

3 
O 


3 

CL 

Z 


3 
a, 
Z 


< 

a 

3 


5 


♦- a 


}- 
3 
a. 
h- 

O 


3 
a. 
J- 
3 
O 


H 
3 
a. 

h- 
3 
O 


H 
3 
a. 
t~ 
3 
O 


3 
a. 


3 
a. 
Z 


3 
a. 

Z 


(- 
3 
a. 
Z 


H 

3 
a. 

J- 
3 
O 


3 
a. 
H- 
3 
O 


h- 

3 
a. 
K 
3 
O 


H 

3 
a. 

i- 
3 
O 


3 

CL 

Z 


3 
a. 

Z 


3 

CL 

Z 


K 
3 
a. 

Z 


< 

£ 


t- 
3 
a. 

3 
O 


h- 

3 

Q. 

h- 

3 
O 


3 
o. 

3 
O 


3 
a. 

3 
O 


3 
0_ 

h- 
3 
O 


3 
l_ 
3 
O 


H 

3 

Q- 

(- 

3 
O 


H 
3 

CL 

3 
O 


h- 
3 
a. 
Z 


a. 

Z 


3 

CL 

Z 


3 
a. 

Z 


)- 

3 

CL 

Z 


h- 
3 
a. 
Z 


3 

CL 

Z 


H 
3 

CL 

Z 


m 
■a 
o 

3 
o 

e 

3 


a 

a 


o 


- 


o 


- 


o 


- 


o 


- 


o 


- 


o 


- 


o 


- 


o 


- 


a* 


o 


o 


- 


- 


o 


o 


- 


- 


o 


o 


- 


- 


o 


o 


- 


- 


a 


o 


o 


o 


o 


o 


a 


o 


o 


o 


o 


a 


o 


o 


o 


o 


o 


pi 
a 


o 


o 


o 


o 


- 


- 


- 


- 


o 


o 


o 


o 


- 


- 


- 


- 




o 


o 


o 


o 


o 


° 


o 


o 


















in 
O 


o 


o 


o 


o- 


o 


o 


o 


o 


o 


o 


o 


o 


o 


o 


o 


o 


to 

a 


o 


o 


o 


o 


o 


o 


o 


o 


o 


o 


o 


o 


o 


o 


o 


o 


a 




































o 
z 


o 


H 


CM ! 


CO 


"3- 


If) 


CD 


- 


CO 


Ol 


o 


- 


CN 


CI 


*? 


in 



\ 



k 



^u. 



K- 



H^ 



x 




■= ?. c B 3 



£ .= >- S 



6" 
S i 



o 


C 


a. 


c 
o 
o 












o 




3! 












c 


CD 


a: 


a 


=£ 


O 


iX 


G 

3 




<f 






O 




ca 


















t- 


a. 






3 


•: 


,0 




O 










J3 


o 




a 


























* 


^ 


S 


■o 



a w c m 2 




■a S in .! 
.2 > cm 

Js-O CO 

e a z 

o « — 

C 3 U 

Si3z 



3 Z c" -o ^ te 



x: 3 c S 

" o - ., 



: •ss.i 

> m % 
llll 



.2 ° c -I 2 
— * ° h. 2 

Oil; 

QT) = g = 



E 



^5 - 



m " ™ - 1 "" 



51 



S 5 -o 

.2 c > 

O W 

2 tx > 

"I: 



s:ip 



z „ = o < 
I « 



3 ' i 

o CO ' 



~* §<c s 



Q LL1 

I t- "(5 

r«< c 



S - S " 

to CC " ; 

Q H T3 "i 



3 S'S'D 

c 1 £ 

K v» O 5 t: 

1 -S I s f 

'; c £ 



< o • 



■a s ° = S 
• s * - 1 .5 



1: 5> 5 
i- o o S £ c 



> o o 

> ^ CL 
■ ? -^ 



.E'i's.'s 



15 -c 
Z^ H ■ 
co *± 



_v l 



■ S 5 ■ 

£ ° ^s " 

o « k -u ' 

■;' .. 1- 

c „ <u n : 

— CO J3 w 

O _ *- ■ 

o >" t; oj 






J 



302 




TO 

o 
o 



1 

O 



II 




1 


'l 




l h 


liiJ L> 


H£ 


< 


llsl » T 












._ 



! Z Z 



y 



X 



X 



IS l< - § 




ftiit-ifti 




•D 

C 

8 
1 



ill 

Ji u a 
c a ° 
'5 o « 
: c £ 


tf, ,1 


ese "handshaking 
eral device Since 
ation. a norma! 

MODE 1 [PORTS) 


13 


« w O 





. m *- O 

I5!« 

mi 

• i ° 2 

if it 
3€« : 



SI 

% 1 



: S c 
; u o 

- d< § 

< a, O — 

~ j= SS ■- 
o co t: 

-r, »Z I 







. t- i- 
; z z 



k 



, ; , , rl t 



SS So IS 



I 



303 



o 
o 

w 

■o 
o 

2 



& 



£ .9- 
E .s 



"Z -d S 

3 s <= 






O OJ C 
5, T= 3 



*2 n , ro -a 



« «" S 

2 .£ 



2 

c 



* 5 



Hi 



8 8 



'I « 



E-E^o 

o 3 " 



„ £ S 

-a '-a a 

isr 



5 l§ R JH j 


? S 








u~ 


W ' 




., ., 


O 


. 




j.i 








« 




1-1 






V 


, , ■ . 




II 






























°" ^L °" "■ °" °" £ 


t. 


a £ 


a 






























S % 







i lb 


; !« 5 


r it 






It 






' 


m 


. 


i 







tl 



it 

IS II 



?m 



E IS Ik s 

mil 



2 °„e 



e g 



S 11 II 


H 


l|l 1 mh lili 


' 



A 



8ZZ 

Z .- M 




A 



V 



A 



V 



304 



\®. 



Z80-CPU 
Z80A-CPU 




The Zilog Z80 product line is a complete set of micro- 
computer components, development systems and support 
software. The Z80 microcomputer component set includes 
all of the circuits necessary to build high-performance 
microcomputer systems with virtually no other logic and a 
minimum number of low cost standard memory elements. 

The Z80 and Z80A CPU's are third generation single chip 
microprocessors with unrivaled computational power. This 
increased computational power results in higher system 
through-put and more efficient memory utilization when 
compared to second generation microprocessors. In 
addition, the Z80 and Z80A CPU's are very easy to imple- 
ment into a system because of their single voltage require- 
ment plus all output signals are fully decoded and timed to 
control standard memory or peripheral circuits. The circuit 
is implemented using an N-channel, ion implanted, silicon 
gate MOS process. 

Figure 1 is a block diagram of the CPU, Figure 2 details 
the internal register configuration which contains 208 bits 
of Read/Write memory that are accessible to the program- 
mer. The registers include two sets of six general purpose 
registers that may be used individually as 8-bit registers or 
as 16-bit register pairs. There are also two sets of accumu- 
lator and flag registers. The programmer has access to either 
set of main or alternate registers through a group of ex- 
change instructions. This alternate set allows foreground/ 
background mode of operation or may be reserved for very 
fast Interrupt response. Each CPU also contains a 16-bit 
stack pointer which permits simple implementation of 



Product Specif icatkm 



MARCH 1978 



multiple level interrupts, unlimited subroutine nesting and 
simplification of many types of data handling. 

The two 16-bit index registers allow tabular data manipu- 
lation and easy implementation of relocatable code. The 
Refresh register provides for automatic, totally transparent 
refresh of external dynamic memories. The I register is used 
in a powerful interrupt response mode to form the upper 8 
bits of a pointer to a interrupt service address table, while 
the interrupting device supplies the lower 8 bits of the 
pointer. An indirect call is then made to this service address. 



FEATURES 

® Single chip, N-channel Silicon Gate CPU. 

a> 1 58 instructions-includes all 78 of the 8080A instruc- 
tions with total software compatibility. New instruc- 
tions include 4-, 8- and 16-bit operations with more 
useful addressing modes such as indexed, bit and relative. 

» 17 internal registers. 

® Three modes of fast interrupt response plus a non- 
maskable interrupt. 

a Directly interfaces standard speed static or dynamic 
memories with virtually no external logic. 

• 1.0 /us instruction execution speed. 

a Single 5 VDC supply and single-phase 5 volt Clock. 

8 Out-performs any other single chip microcomputer in 
4-, 8-, or 16-bit applications. 

e All pins TTL Compatible 

« Built-in dynamic RAM refresh circuitry. 
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Z80, Z80A CPU BLOCK DIAGRAM 



MAIN REG SET 



ALTERNATE REG SET 



' 4- w 


ACCUMULATOR 

A 


FLAGS 

F 


ACCUMULATOR 
A' 


FLAGS 

F 


B 


C 


B r 


C 


D 


E 


0' 


E' 


H 


L 


H' 


L - 



GENERAL 
PURPOSE 
REGISTERS 



INDEX REGISTER 



INDEX REGISTER 



STACK POINTER 



PROGRAM COUNTER 
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Z80, Z80A-CPU Pin Description 



CPU f'gr 

BUS <J __ 

CONTROL l^BL 



RFSH 

(Refresh) 



HALT 
(Halt state) 



Output, active low. RFSH indicates that 
the lower 7 bits of the address bus con- 
tain a refresh address for dynamic 
memories and the current MREQ signal 
should be used to do a refresh read to all 
dynamic memories. 



Output, active low. HALT indicates that 
the CPU has executed a HALT software 
instruction and is awaiting either a non- 
maskable or a maskable interrupt (with 
the mask enabled) before operation can 
resume. While halted, the CPU executes 
NOP's to maintain memory refresh 
activity. 



Z80, Z80A CPU PIN CONFIGURATION 

Afj-Aj5 Tn-state output, active high. Aq-A]5 

(Address Bus) constitute a 16-bit address bus. The 
address bus provides the address for 
memory (up to 64K bytes) data 
exchanges and for I/O device data exchanges. 

Dq -D7 Tn-state input/ output, active high. 

(Data Bus) Dq - D7 constitute an 8-bit bidirectional 

data bus. The data bus is used for data 
exchanges with memory and I/O devices. 



WAIT Input, active low. WAIT indicates to the 

(Wait) Z-80 CPU that the addressed memory or 

I/O devices are not ready for a data 
transfer. The CPU continues to enter wait 
states for as long as this signal is active. 

INT Input, active low. The Interrupt Request 

(Interrupt signal is generated by I/O devices. A 

Request) request will be honored at the end of the 

current instruction if the internal soft- 
ware controlled interrupt enable flip-flop 
(IFF) is enabled. 



M, 

(Machine 
Cycle one) 



MREQ 

(Memory 

Request) 



IORQ 

(Input/ 
Output 
Request) 



RD 

(Memory 
Read) 



WR 

(Memory 
Write) 



Output, active low. Mj indicates that the 
current machine cycle is the OP code 
fetch cycle of an instruction execution. 

Tri-state output, active low. The memory 
request signal indicates that the address 
bus holds a valid address for a memory 
read or memory write operation. 



Tn-state output, active low. The IORQ 
signal indicates that the lower half of the 
address bus holds a valid I/O addr ess for 
a I/O read or write operation. An IORQ 
signal is also generated when an interrupt 
is being acknowledged to indicate that an 
interrupt response vector can be placed 
on the data bus. 



Tri-state output, active low. RD indicates 
that the CPU wants to read data from 
memory or an I/O device. The addressed 
I/O device or memory should use this 
signal to gate data onto the CPU data bus. 



Tn-state output, active low. WR indicates 
that the CPU data bus holds valid data to 
be stored in the addressed memory or I/O 
device. 



NMI 
(Non 
Maskable 
Interrupt) 



RESET 



BUSRQ 

(Bus 

Request) 



BUSAK 

(Bus 

Acknowledge) 



Input, active low. The non-maskable 
nterrupt request line has a higher priority 
than INT and is always recognized at the 
end of the current instruction, indepen- 
dent of t he sta tus of the interrupt enable 
flip-flop. NMI automatically forces the 
Z-80 CPU to restart to location 0066 H . 



Input, active low. RESET initializes the 
CPU as follows: reset interrupt enable 
flip-flop, clear PC and registers I and R 
and set interrupt to 8080A mode. During 
reset time, the address and data bus go to 
a high impedance state and all control 
output signals go to the inactive state. 

Input, active low. The bus request signal has 
a higher priority than NMI and is always rec- 
ognized at the end of the current machine 
cycle and is used to request the CPU address 
bus, data bus and tri-state output control 
signals to go to a high impedance state so 
that other devices can control these busses. 

Output, active low. Bus acknowledge is 
used to indicate to the requesting device 
that the CPU address bus, data bus and 

tn-state control bus signals have been set 
to their high impedance state and the 
external device can now control these signals. 
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Timing Waveforms 



INSTRUCTION OP CODE FETCH 



The program counter content (PC) is placed on the 
address bus im mediately at the start of the cycle. One half 
clock t ime later MREQ goes active. The falling edge of 
MREQ can be u sed directly as a chip enable to dynamic 
memories. RD when active indicates that the memory 
data should be enabled onto the CPU data bus. The CPU 
samples data with the rising edge of the clock state T3. 
Clock states T3 and T4 of a fetch cycle are used to refresh 
dynamic memories while the CPU is internally decoding 
and executing the instruction. The refresh control signal 
RFSH indicates that a refresh read of all dynamic memories 
should be accomplished. 



AO - A15 
MREO 



D0-D7 

RFSH 



hi 



-MlCycli- 



-GEh 



j REFRESH ADPfT 



_r 



MEMORY READ OR WRITE CYCLES 



Illustrated here is the timing of memory read or write 
cycles_other than an OP code fetch (Mi cycle). The MREQ 
and RD signals are used exactly as in the fetc h cycle. In 
the case of a memory write cycle, the MREQ also becomes 
active when the address bus is stable so that it can be used 
directly as a chip enable for dynamic memories. The WR 
line is active when data on the data bus is stable so that it 
can be used directly as a R/W pulse to virtually any type of 
semiconductor memory. 




INPUT OR OUTPUT CYCLES 



Illustrated here is the timing for an I/O read or I/O write 
operation. Notice that during I/O operations a single wait 
state is automatically inserted (Tw*). The reason for this is 
that during I/O operations this extra state allows sufficient 
time for an I/O port to decode its address and activate the 
WAIT line if a wait is required. 
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INTERRUPT REQUEST/ACKNOWLEDGE CYCLE 



The interrupt signal is sampled by the CPU with the 
rising edge of the last clock at the end of any instruction. 
When an interrupt is accepted, a spe cial M ] cycle is 
generated. Durin g this M j cycle, the IORQ signal becomes 
active (instead of MREQ) to indicate that the interrupting 
device can place an 8-bit vector on the data bus. Two wait 
states (Tw*) are automatically added to this cycle so that a 
ripple priority interrupt scheme, such as the one used in the 
Z80 peripheral controllers, can be easily implemented. 
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A.C. Characteristics 



Z80-CPU 



T A = O o Cto70 o C,Vcc ; 



+5V ± 5%, Unless Otherwise Noted. 



Signal 


Symbol 


Parameter 


Min 


Max 


Unit 


Test Condition 


* 


l w W'MI 

l w ('l>L) 
'i.l 


Clock Period 

Clock Pulse Width, Clock High 
Clock Pulse Widlli. Clock Low 
Clock Rise and Fall Time 


.4 


u:i 


usee 




180 


|E| 


nsec 


ISO 


2000 


nscc 




.10 


nsec 


Vis 


'DIADI 

'FIADI 

'aem 

>aci 

'ca 

'cat 


Address Oulpu! Delay 

Delay lo Floal 

Address Slable Prior to MRF.Q (Memory Cycle i 

Address Slable Prior lo IORQ. RD or WR (I/O Cycle! 

Address Slable Inini RD, WR, IORQ or MREQ 

Address Slable From RD or WR During Floal 




145 


nsec 


C L = 50pF 




no 


nsec 


III 




nsec 


1:1 




nsec 


131 




nsec 


Ml 




nsec 


D 0-7 


'DIDI 

'F(DI 

'S*(D! 

'S*(DI 

'dcrn 

'dci 

'cdf 


Dala Output Delay- 
Delay lo Floal During Write Cycle 

Dala Setup Time lo Rising Edge ol' Clock During M 1 Cycle 
Data Setup Time to Falling Edge of Clock During M2 to M5 
Dala Slable Prior lo WR (Memory Cycle) 
Dala Slable Prior lo WR (I/O Cycle! 
Dala Slable From WR 




230 


nsec 


C L = 50pF 




90 


nsec 


So 




nsec 


60 




nsec 


151 




nsec 


(6l 




nsec 


171 








l H 


Any Hold Time lor Selup Time 







nsec 




MREQ 


'DL*(MR> 

'DH*(MR1 

'DH*(MR> 

'w(MRLi 

'w(MRH) 


MREO Delay From Falling Edge of Clock, MREQ Low 
MREQ Delay From Rising Edge uf Clock, MREQ High 
MREQ Delay From Falling Edge of Clock. MRE'j High 
Pulse Width, MREO Low 
Pulse Width. MREQ High 




100 


nsec 


C L = 50pF 




100 


nsec 




100 


nsec 


181 




nsec 


191 




nsec 


fORQ 


'DL*(IR) 
•DL* (1R) 
<DH*(IR) 
'DH*(IR) 


IORQ Delay From Rising Edge of Clock, IORQ Low 
IORQ Delay From Falling Edge of Clock, IORQ Low 
IORQ Delay From Rising Edge of Clock, IORQ High 
IORQ Delay From Falling Edge of Clock, IORQ High 




90 


nsec 


C L = 50pF 




no 


nsec 




100 


nsec 




nb 


nsec 


RD 


'DL* (RD) 
C DL*(RD) 
•DH*(RD) 
'DH* (RD) 


RD Delay From Rising Edge of Clock, RD Low 
RD Delay From Falling Edge of Clock, RD Low 
RD Delay From Rising Edge of Clock, RD High 
RD Delay From Falling Edge of Clock, RD High 


, 


100 


nsec 


C L = 50pF 




130 


nsec 




100 


nsec 




no 


nsec 


WR 


'DL*(WR) 
■DL*(WR) 
l DH*(WR) 
'w (WRU 


WR Delay From Rising Edge of Clock, WR Low 
WR Delay From Falling Edge of Clock, WR Low 
WR Delay From Falling Edge of Clock, WR High 
Pulse Width, WR Low 




80 


nsec 


C L =50pF 




90 


nsec 




100 


nsec 


[101 




nsec 


Ml 


'DL(Ml) 
'DHfMI) 


M 1 Delay From Rising Edge of Clock. Ml Low 
Ml Delay From Rising Edge of Clock, Ml High 




130 


nsec 


C L =50pF 




130 


nsec 


RFSH 


'DL(RF) 
'DH(RF) 


RFSH Delay From Rising Edge of Clock, RFSH Low 
RFSH Delay From Rising Edge of Clock, RFSH High 




180 


nsec 


C L = 50pF 




150 


nsec 


WAIT 


's(WT) 


WAIT Selup Time to Falling Edge of Clock 


70 




nsec 




HALT 


'D(HT) 


HALT Delay Time From Falling Edge of Clock 




300 


nsec 


C L = 50pF 


INT 


's(IT) 


INT Setup Time lo Rising Edge of Clock 


80 




nsec 




NMf 


'w (NMD 


Pulse Width, NMJ Low 


80 




nsec 




BUSRQ 


's(BQ) 


BUSRQ Selup Time to Rising Edge of Clock 


80 




nsec 




BUSAK 


'DL(BA) 
'DHIBAI 


BUSAK Delay From Rising Edge of Clock, BUSAK Low 
BUSAK Delay From Falling Edge of Clock, BUSAK High 




120 


nsec 


C L =50pF 




110 


nsec 


RF.SF.T 


•s (RS> 


RESET Selup Time lu Rising Edge of Clock 


90 




nsec 






'F(C) 


Delay lo Floal (MREQ. TORQ, RD and WR) 




100 


nsec 






'mr 


Ml Slable Prior lo IORQ (Interrupt Ack.l 


111) 




nsec 





'w(.|.H)* l w(*Ll + ' 



cm"'w(*H) + 'f- 75 
aci = 'c ~ K0 
ca = 1 w(*LI + 'r- 40 
caf = 'w(.l.LI +l r-''° 



dem " 



■210 



dci " \v(*L) T l r 
cdf =t w(*U + , r- 



+ 1-210 



ffl i,. 



'w(MRHI~ \v(*HI + ' 



(10| t. 



w(WRI_) - 'c 



■40 



|l'| 



: 'c* 'nH'HI* 'f- 80 



NOTES: 

A. Dala should be enabled .into Hie CPU d ata bus when RD is active. During interrupt acknowledge dala 

should be enabled when M I and IORQ are bolh aclive. ran. 

B. All control signals are internally synchronised, so they may be tolally asynchronous will] respect "*™ 
to th e clock . 

C. The RESET signal must be aclive lor a minimum of 3 clock cycles. 

D. Output Delay vs. Loaded Capacitance 

TA = 70°C Vcc = +5V ±55. 

Add 1 Onsec delay for each SOpf increase in load up to a maximum of 200pf for the data bus & 1 OOpf for 
address & control lines 

h Although sialic by design, testing guarantees l^.j,^) of 200 usee maximum 



rrsr point 



' 1 I$' 



Load circuit for Output 
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A.C. Timing Diagram 



Timing measurements are made at the following 

voltages, unless otherwise specified: "'" "°" 

B " CLOCK V CC -.6V .4SV 

OUTPUT 2.0 V .8 V 

, i INPUT 2.0 V .8 V 

" C FLOAT 4V ±0.5 V 



A 0-A15 



'IN 



J 0-7 ' 



RFSH 



MREQ 



IORQ 



HO 



BUSRQ 



BUSAK 



RESET 



\ 



' r 

— 'S'l'IOI— 



'dhwii- 



-*s- 



-st 

'OL'MRD! 'DH.MROI— 
U 



X 



-\ 



'dh'Miri— 



> 



X 



/ 



■VH— 



X 






'DHIRF 



/ i >Jr--'W(MRL)--4/ ? l 



'W (MRH! 



^ 



XZZK 



3C 



IT 



\ 
\ 



ruir 



X 



dcm- 
f Dl"l"(IRJ 



^i 



-^ 



X 



'oi+<«mi 






KZ 



'V» (NMU|- — H 



'S (RSI 



IX. 




K. 




-'d 



A 




ZXZDC 



..X" 




:zxzx 
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Absolute Maximum Ratings 

Temperature Under Bias Specified operating runge. 

Storage Temperature -6S°C to + 1 50°C 

Voltage On Any Pin -0.3V to +7V 

with Respect to Ground 

Power Dissipation 1.5W 



•Comment 

Stresses above those listed under "Absolute 
Maximum Rating" may cause permanent 

damage to the device. This is a stress rating 
only and functional operation of the device 
at these or any other condition above those 
indicated in the operational sections of this 
specification is not implied. Exposure to 
absolute maximum rating conditions for 
extended periods may affect device reliability. 



Note: . For Z80-CPU alt AC and DC characteristics remain the 
same for the military grade parts except i cc - 



Z80-CPU D.C. Characteristics 



T A =0°C 


to 70°C. V cc = 5V + 5% unless otherwise spec 


(led 










Symbol 


Parameter 


Min. 


Typ. 


Max. 


Unit 


Test Condition 


V ILC 


Clock Input Low Voltage 


-0.3 




0.4S 


V 




V IHC 


Clock Input High Voltage 


Vcc -6 




V„ +.3 
cc 


V 




V IL 


Input Low Voltage 


-0J 




0.8 


V 




V IH 


Input High Voltage 


:.o 




V 

cc 


V 




V 0L 


Output Low Voltage 






0.4 


V 


l 0[ _= 1.8 mA 


V OH 


Output High Voltage 


:.4 






V 


l 0H - -cSOuA 


'cc 


Power Supply Current 






150 


mA 




'LI 


Input Leakage Current 






10 


MA 


v IN=»'» V cc 


'loh 


Trt-Slate Output Leakage Current in Float 






10 


M 


V OUT =2.4,oV cc 


! LOL 


Tn-State Output Leakage Current m Float 






-10 


WA 


V OUT =0.4V 


'ld 


Data Bus Leakage Current in Input Mode 






±10 


HA 


o<v IN <v cc 



Capacitance 

T A = 25°C, f = 1 MHz, 
unmeasured pins returned to ground 



Symbol 


Parameter 


Max. 


Unit 


c* 


Clock Capacitance 


35 


pF 


C IN 


Input Capacitance 


5 


pF 


C OUT 


Output Capacitance 


10 


PF 



Z80-CPU 

Ordering Information 

C - Ceramic 

P - Plastic 

S - Standard SV 15% 0° to 70°C 

E - Extended 5V ±5% -40° to 8S°C 

M - Military 5V tlO%-5 5° to 125°C 



Z80A-CPU D.C. Characteristics 



= 0T i..7() C" V. 



' * ^' ■ unk'^N uiherutsc spccihed 



Symbol 


Parameter 


Min. 


Typ. 


Max. 


Unit 


Test Condition 


V ILC 


Clock lupin Low Voltage 


-0.3 




0.45 


V 




V IIIC 


Clock Input High Voltage 


V cc-6 




v cc + - 3 


V 




V IL 


Input Low Voltage 


-U.J 




OK 


V 




V lll 


Input High Vohagc 


:.o 




V.^ 


V 




V ()l 


Otilpul Low Voltage 






0.4 


V 


l 0L = 1.8mA 


V OII 


Ouiptil lligji Voliage 


;.4 






V 


l ()1| = -3UuA 


'cc 


Powei SuppK Cuirent 




90 


:oo 


mA 




'i.l 


lupin Leakage Cuireiil 






10 


JiA 


V IN =U »' V cc 


1 1 on 


Tn-Sljle Ouiptil Leakage Cuncnl in Float 






10 


(i.A 


v our : -"" v cc 


'lOl 


Tri-Slale Output 1 eakageCuitent in Float 






-10 


MA 


V OUT =0.4V 


'id 


Data Bus Leakage Cutrenl in Input Mode 






110 


uA 


o<v |N <v cc 



Capacitance 

T A = 25°C, f = I MHz. 
unmeasured pins returned tu ground 



Symbol 


Parameter 


Max. 


Unit 


c.„ 


Clock Capacitance 


35 


pi- 


l 'lS 


lupin Capacitance 


< 


pi- 


c ou 


Output Capacitance 


10 


1'F 



Z80A-CPU 
Ordering Information 



C - Ceramic 

P - Plastic 

S - Standard 5V ±5% 0° to 70"C 
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A.C. Characteristics 



Z80A-CPU 



T A = 0°C to 70°C, Vcc = +5V + 5%, Unless Otherwise Noted. 



Signal 


Symbol 


Parameter 


Min 


Max 


Unit 


Test Condition 


* 


i w (*H) 

'r.f 


Clock Period 

Clock Pulse Widlh, Clock High 
Clock Pulse Widlh, Clock Low 
Clock Rise and Fall Time 


.25 


u:i 


usee 




110 


|E| 


nsec 


110 


2000 


nsec 




JO 


nsec 


^1-1 5 


'D(AD) 

'F(AD) 

l acm 

'ael 

<ca 

'car 


Address Output Delay 

Delay to Float 

Address Stable Prior to MREQ (Memory Cycle) 

Address Stable Prior to 10RQ, RD or WR (I/O Cycle 1 

Address Stable from RD. WR. 10RQ or MREO 

Address Stable From RD or WR During Float 




no 


nsec 


C L = 50pF 




90 


nsec 


111 




nsec 


121 




nsec 


IJI 




nsec 


|4| 




nsec 


D 0-7 


'D(D) 

'F(D) 

'S* (Dl 

'S* (D) 

l dcm 

■del 

'cdf 


Data Output Delay 

Delay to Float During Write Cycle 

Data Setup Time to Rising Edge of Clock During Ml Cycle 

Data Setup Time to Failing Edge of Cluck During M2 to M5 

Data Stable Prior to WR (Memory Cycle) 

Data Stable Prior to WR (I/O Cycle) 

Data Stable From WR 




150 


nsec 


C L =50pf 




90 


nsec 


35 




nsec 


50 




nsec 


151 




nsec 


161 




nsec 


I7| 








<H 


Any Hold Time for Setup Time 







nsec 




MREQ 


'DL*(MR) 
'DH* (MR) 
'DH* (MR) 
! w (MRL) 
'w (MRH) 


MREQ Delay From Falling Edge of Clock, MREQ Low 
MREQ Delay From Rising Edge of Clock, MREQ High 
MREQ Delay From Falling Edge of Clock. MREQ High 
Pulse Widlh, MREQ Low 
Pulse Width, MREQ High 




85 


nsec 


C L = 50pF 




85 


nsec 




85 


nsec 


181 




nsec 


I9l 




nsec 


JORQ 


'DL* (IR) 
'DL* (IR) 
'DH* (IR) 
>DH*(1R) 


IORQ Delay From Rising Edge of Clock, IORQ Low 
10RQ Delay From Falling Edge of Clock, IORQ Low 
IORQ Delay From Rising Edge of Clock, IORQ High 
IORQ Delay From Falling Edge of Clock, IORQ High 




75 


nsec 


C L -50pF 




85 


nsec 




85 


nsec 




85 


nsec 


RD 


'DL* (RD) 
'DL*(RD> 
'DH*(RD) 
'DH* (RD) 


RD Delay From Rising Edge of Clock, RD Low 
RD Delay From Falling Edge of Clock, RD Low 
RD Delay From Rising Edge of Clock. RD High 
RD Delay From Falling Edge of Clock, RD High 




85 


nsec 


C L =50pF 




95 


nsec 




85 


nsec 




85 


nsec 


WR 


'DL* (WR) 
'DL* (WR) 
'DH* (WR) 
'w(WRD 


WR Delay From Rising Edge of Clock, WR Low 
WR Delay From Falling Edge of Clock, WR Low 
WR Delay From Falling Edge of Clock, WR High 
Pulse Widlh, WR Low 




65 


nsec 


C L = 50pF 




80 


nsec 




80 


nsec 


110] 




nsec 


Ml 


'DL(MI) 
'DHfMl) 


MI Delay From Rising Edge of Clock. Ml Low 
Ml Delay From Rising Edge of Clock, MI High 




100 


nsec 


C L = 50pF 




100 


nsec 


RFSH 


'DL(RF) 
'DH (RF) 


RFSH Delay From Rising Edge of Clock, RFSH Low 
RFSH Delay From Rising Edge of Clock. RFSH High 




130 


nsec 


C L = 50pF 




120 


nsec 


WaTT 


's(WT) 


WAIT Setup Time to Falling Edge of Clock 


70 




nsec 




HALT 


'D(HT) 


HALT Delay Time From Falling Edge of Clock 




300 


nsec 


C L = 50pF 


INT 


's (IT) 


INT Setup Time to Rising Edge of Clock 


80 




nsec 




nmT 


'w (NMD 


Pulse Width, NMi Low 


80 




nsec 




BUSRQ 


's(BQ) 


BUSRQ Setup Time to Rising Edge of Clock 


50 




nsec 




BUSAK 


'DL(BA) 
'DH (BA) 






100 


nsec 


C L = 50pF 


BUSAK Delay From Rising Edge of Clock, BUSAK Low 
BUSAK Delay From Falling Edge of Clock, BUSAK High 




100 


nsec 


RESET 


's (RS) 


RESET Setup Time to Rising Edge of Clock 


60 




nsec 






'F(C) 


Delay to Float (MREO, lORQ.RD and WR) 




80 


nsec 




1 


'mr 


Ml Stable Prior to IORQ (Interrupt Ack.) 


1111 




nsec 





[121 t c - ! w (cJH) * l w(*L) + 'r + 'f 



I'l 'acm = 'w(*H) +1 f- 65 

I 2 1 'acr'c- 70 

t 3 l 'ca^wC+U + 'r" 50 

HI 'car='w(*U + 1 r- 45 

l 5 l 'dcm = 'c-l™ 

' 6 I «dci = t w(*L) + t r- 170 

fl 'cdf-'wCPD + 'r" 70 



181 'w(MRL) = t c- 30 

l 9 l <w(MRH) = 'w(*H) * 'f " 



i |0 i ywRLr'c- 30 



111] 



y*H) Ti f- 



NOTES: 

A. Data should be enabled onto the CPU d ala bus when RD is active. During interrupt acknowledge data 
should be enabled when MT and IORQ are both active. 

B. All control signals are internally synchronized, so they may be totally asynchronous with respect 
to t he clock. 

C. The RESET signal must be active for a minimum of 3 clock cycles. 

D. Output Delay vs. Loaded Capacitance 

TA = 70°C Vcc = +5V ±59t 

Add lOnsec delay for each 50pf increase in load up to maximum of 200pf for data bus and lOOpf for 

address & control lines. 

E. Although static by design, testing guarantees 1^,3,1^ °f 2 °0 ^ sec maximum 




Load circuit for Output 
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NOTES 
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I GLOSSARY 

ACCESS The operation of seeking, reading or writing data on a stor- 
age unit (in this case, the diskette) . 

ACCESS TIME The time that elapses between any instruction being 
given to access some data and that data becoming available for use. 

ACTIVE RECORDS TABLE (ART) A table of binary values in which the 
relative position of a single value determines the status of a record 
with the same relative position; i.e., the Nth binary number 
determines the status of the Nth record. EXAMPLE: If the 8th binary 
number in the table is a zero, then the 8th record is inactive. 
Conversely, if the 8th binary number in the table is a one, then the 
8th record is active. 

ADDRESS An identification (number, name, or label) for a location in 
which data is stored. 

ALGORITHM A computational procedure. 

ALPHANUMERIC (CHARACTERS) A generic term for numeric digits, alpha- 
betic characters, punctuation characters and special characters. 

ALPHANUMERIC STRING A group of characters which may include digits, 
alphabetic characters, punctuation characters and special characters, 
and may include spaces. (NOTEs a space is a 'character 1 to the 
computer, as it must generate a code for spaces as well as symbols.) 



ASCII Abbreviation for American Standard Code for Information 
Interchange. Pronounced: Ass-KEY. Usually refers to a standard 
method of encoding letter, numeral, symbol and special function 
characters, as used by the computer industry. 

ASSEMBLY LANGUAGE A machine level language for programming, such as 
Radio Shack's "EDI TOR/ ASSEMBLER" which uses Z-80 processor mnemonics 
and automatically 'assembles' machine readable code from the 
mnemonics. 

BASE A quantity of characters for use in each of the digital 
positions of a numbering system. 

BASE 2 The 'BINARY' numbering system consisting of more than one 
symbol, representing a sum, in which the individual quantity 
represented by each figure is based on a multiple of 2. 

BASE 10 The 'DECIMAL' numbering system - consisting of more than one 
symbol, representing a sum, in which the individual quantity 
represented by each symbol is based on a multiple of 10. 

BASE 16 The 'HEXADECIMAL' numbering system - consisting of more than 
one symbol representing a sum, in which the individual quantity 
represented by each symbol is based on a multiple of 16. 
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BINARY See "BASE 2' 

BIT A single 'BINARY' digit whose value is 'zero 8 or 'one 1 . 

BOOLEAN A form of algebra applied to binary numbers which is 
similar in form to ordinary algebra,, It is especially useful for 
logical analysis of binary numbers as used in computers. 

'BOOT 8 - BOOTSTRAP A machine language program file that is put onto 
every diskette by the 'FORMAT' routine. This routing is invoked when 
reset or power-on occurs. It automatically loads the necessary 
programs (SYS0/SYS) to cause the computer to respond to the DOS 
commands; i.e., the machine is 'BOOTSTRAPPED' or 'BOOTED' into 
operation. 

BUFFER A small area of memory used for the temporary storage of 
data to be processed. 

BUFFER TRACK A track on a diskette used for the temporary storage of 
data or program material during a recovery process. 

BUG A software fault that results in the malfunction of a program. 
May also refer to hardware malfunctions. 

BYTE Eight "BITS'. A 'BYTE' may represent any numerical value 
between '0' and '255'. 

CLOBBERED A slang term referring to the non-operation of software, 
hardware, computer device, or storage media (such as disk) usually as 
the result of a program or hardware error. 

COMMAND FILE A file consisting of a list of commmands, to be executed 
in sequence. 

CONTIGUOUS Adjacent or adjoining. 

CONTROL CODE In programming, instructions which determine conditional 
jumps are often referred to as control instructions and the time 
sequence of execution of instructions is called the flow of control. 

CRC ERROR Cyclic Redundancy Check. A means of checking for errors by 
using redundant information used primarily to check disk I/O on the 
TRS-80. 

DATA BASE A collection of interrelated data stored together with 
controlled redundancy to serve one or more applications. The data are 
stored so that they are independent of programs which use the data. A 
common and controlled approach is used in adding new data and in 
modifying and retrieving existing data within a data base. A system 
is said to contain a collection of data-based information if they are 
disjoint in structure. 
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DATA BASE MANAGEMENT SYSTEM The collection of software required for 
using a data base. 

DATA ELEMENT Synonymous with "DATA ITEM' or "FIELD' 

DATA TYPE The form in which data is stored; i.e., integer, single 
precision, double precision, 'alphanumeric' character strings or 
' strings ' . 

DEC Initials for Directory Entry Code. 

DECIMAL See 'BASE 10'. 

DIRECT ACCESS Retrieval or storage of data by a reference to its 
location on a disk, rather than relative to the previously retrieved 
or stored data. 

DIRECT STATEMENT (IN FILE) A program statement that exists in the 
disk file that is not assigned a line number. 

DIRECTORY A table giving the relationships between items of data. 
Sometimes a table or an index giving the addresses of data. 

DISPLACEMENT A specified number of sectors, at the top or beginning 
of the file, in which the 'bookkeeping' and file parameters are stored 
for later use by the various program modules. 

DISTRIBUTED FREE SPACE Space left empty at intervals in a data lay- 
out to permit the possible insertion of new data. 

DOUBLE PRECISION A positive or negative numeric value, 16 digits in 
length, not including a decimal point (EXAMPLE: 99999999999999.99). 

DUMP To transfer all or part of the contents of one section of 
computer memory or disk into another section, or to some other 
computer device. 

DYNAMIC STORAGE ALLOCATION The allocation of storage space by a pro- 
cedure based on the instantaneous or actual demand for storage space 
by that procedure, rather than allocating storage space to a 
procedure based on its anticipated or predicted demand. 

EATEN (DIRECTORY/DISK) Slang term. See 'CLOBBERED'. 

EMBEDDED POINTERS Pointers in the data records rather than in a di- 
rectory. 

ENTITY Something about which data is recorded. 

EOF Initials for 'END OF FILE'. It is common practice to say that 

the EOF is record number nn or that the EOF is byte 15 of sector 12. 

Hence, it is a convenient term to use in describing the location of 
the last record or last byte in a file. 
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EXTENT A contiguous area of data storage,, 

FILE A collection of related records treated as a unit; The word 

file is used in the general sense to mean any collection of 

informational items similar to one another in purpose? form and 
content* 

FILE PARAMETERS The data that describes or defines the structure of 

the file,, 

FILESPEC A file specification and may include the 'FILE NAME', 'FILE 
NAME EXTENSION', "PASSWORD" , and "DISK DRIVE" specification,, 

FIELD See "DATA ITEM'., 

FLAKY Slang term -Alludes to less than acceptable performance. 

FILE AREA The physical location of the file, on the disk, or in 
memory* 

"FPDE" Initials for File Primary Directory Entry? a file's entry and 
file area pointers in the disk directory, 

"FXDE" Initials for File Extended Directory Entry; a file's entry and 
file area pointers, in the case of an overflow in the 'FPDE'. 

GAT Initials for Granule Allocation Table; A table from which 
available file areas are assigned to file entries. 

GRANULE Unit of 5 sectors. On the TRS-80 disk operating system, a 
•granule" is the basic unit of disk storage allocation. The diskette 
"DIRECTORY" file keeps track of free and assigned disk space in terms 
of "granules • . 

HASH CODE A code number generated and used as a direct addressing 
technique in which the key is converted to a pseudo-random number from 
which the required address is derived. 

HEADER RECORD A record containing common, constant or identifying 
information for a group of records which follow. 

HEXADECIMAL See "BASE 16" 

HIT Initials for Hash Index Table; an addressing technique in which a 
disk file is referenced by a code number in a table, and the position 
of that code in the table relates to the file entry in the directory. 

INDEX A table used to determine the location of a record. 

INDIRECT ADDRESSING Any method of specifying or locating a storage 
location whereby the key (of itself or through calculation) does not 
represent an address. For example, locating an address through 
indices . 
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INSTRING (INSTRING SEARCH) Refers to the capability of locating a 
substring of characters that may exist in another character string. An 
example would be: Substring = "THE" String = "NOW IS THE TIME" „ An 
INSTRING routine would locate the substring and return its starting 
position within that string. In this example, it would return a value 
of eight. 

INTEGER A natural or whole number. In the TRS-80, integer values may 
not exceed the range of +32767 to -32768. 

INVERTED FILE A file structure which permits fast spontaneous 
searching for previous unspecified information. Independent lists or 
indices are maintained in records' keys which are accessible according 
to the values of specific fields. 

INVERTED LIST A list organized by a secondary key not a primary 

key. 

IPL Initials for Initial Program Loader; a program usually executed 
upon pressing of the 'RESET' button. 

KEY A data item used to identify or locate a record or other data 

grouping. 

LABEL A set of symbols used to identify or describe an item, record, 
message or file. Occasionally, it may be the same as the address in 
storage. 

LEAST SIGNIFICANT BYTE The significant byte contributing the smallest 
quantity to the value of a numeral. 

LIST An ordered set of data items. A 'chain 1 . 

LOAD MODULE A program developed for loading into storage and being 
executed when control is passed to the program. 

LOCK-OUT (TRACKS) Unusable tracks, on the disk, that are not 
accessible because of damage or by user option. 

LOGICAL An adjective describing the form of data organization, 

hardware or system that is perceived by an application program, 

programmer, or user; it may be different than the real (PHYSICAL) 
form. 

LOGICAL DATA-BASE DESCRIPTION A schema. A description of the 
overall data-base structure, as perceived for the users, which is 
employed by the data base management software. 

LOGICAL FILE A file as perceived by an application program; it may 
be in a completely different form from that in which it is stored on 
the storage units. 
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LOGICAL OPERATOR A mathematical symbol that represents a 
mathematical process to be performed on an associated operand. Such 
operators are 'AND 8 , 'OR', 'NOT', 'AND NOT' and "OR NOT'. 

LOGICAL RECORD A record or data item as perceived by an application 
program; it may be in a completely different form from that in which 
it is stored on the storage units. 

LSB See LEAST SIGNIFICANT BYTE. 

MACHINE LANGUAGE Direct machine readable code. 

MAINTENANCE OF A FILE (1) The addition, deletion, changing or 
updating of records in the database, (2) Periodic reorganization of 
a file to better accommodate items that have been added. 

MONITOR A program that may supervise the operation of another program 
for operation or debugging or other purposes. 

MOST SIGNIFICANT BYTE The significant byte contributing the greatest 
quantity to the value of a numeral. 

MSB See MOST SIGIFICANT BYTE. 

MULTIPLE-KEY RETRIEVAL Retrieval which requires searches of data 
based on the values of several key fields (some or all of which are 
secondary keys) . 

NULL An absence of information as contrasted with zero or blank for 
the presence of no information. 

NYBBLE The four right most or left most binary digits of a byte. 

ON-LINE An on-line system is one in which the input data enter the 
computer directly from their point of origin, and/or output data are 
transmitted directly to where they are used. The intermediate stages 
such as writing tape, loading disks or off-line printing are avoided. 

ON-LINE STORAGE Storage devices and especially the storage media 
which they contain under the direct control of a computing system, not 
off-line or in a volume library. 

OPEN RECORDS TABLE (ORT) A table of binary values in which the 
relative position of a single value determines the status of a record 
with the same relative position; i.e., the Nth binary number 
determines the status of the Nth record. EXAMPLES If the 8th binary 
number in the table is a zero, then the 8th record is open. 
Conversely, if the 8th binary number in the table is a one, then the 
8th record is on file. 

OPERATING SYSTEM Software which enables a computer to supervise its 
own operations, automatically calling in programs, routines, language 
and data as needed for continuous throughput of different types of 
jobs. 
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PARITY Parity relates to the maintenance of a sameness of level or 
count, i.e., keeping the same number of binary ones in a computer word 
and thus be able to perform a check based on an even or odd number for 
all words under examination* 

PHYSICAL An adjective, contrasted with logical, which refers to the 

form in which data or systems exist in reality. Data is often 

converted by software from the form in which it is physically stored 
to a form in which a user or programmer perceives it. 

PHYSICAL DATA BASE A data base in the form in which it is stored on 
the storage media, including pointers or other means of 
interconnecting it. Multiple logical data bases may be derived from 
one or more physical data bases. 

PHYSICAL RECORD A collection of bits that are physically recorded on 
the storage medium and which are read or written by one machine 
input/output instruction. 

POINTER The address or a record (or other data groupings) contained 
in another record so that a program may access the former record when 
it has retrieved the latter record. The address can be absolute, 
relative or symbolic, hence, the pointer is referred to as absolute, 
relative or symbolic. 

PRIMARY ENTRY The main entry made to the directory. Also see 'FPDE'. 

RANDOM ACCESS To obtain data directly from any storage location 
regardless of its position, with respect to the previously referenced 
information. Also called 'DIRECT ACCESS'. 

RANDOM ACCESS STORAGE A storage technique in which the time required 
to obtain information is independent of the location of the 
information most recently obtained. 

READ To accept or copy information or data from input devices or a 
memory register; i.e., to read out, to read in. 

RECORD A group of related fields of information treated as a unit by 
an application program. 

RELATIONAL OPERATOR A mathematical symbol that represents a 
mathematical process to perform a comparison describing the 
relationsnip between two values ( < less than....> greater than... = 
equal.... <> not equal... and combinations thereof (see TRS-80 LEVEL 
II manual, Section 1, Page 5). On the TRS-80, relational comparisons 
may be made on string values as well as numerical values. 

RELATIVE (as pertains to position) An address or position that is 
referenced to a point of origin; i.e. X+20 is a specific positon, 20 
places from the reference point. If the reference point was at 50, 
then the absolute position would be at 70 (50+20=70). Also, 50 (since 
it is the starting reference point) is at relative position 0. 

SCHEMA A map of the overall logical structure of a database. 
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SEARCH To examine a series of items for any that have a desired 
property or properties* 

SECONDARY INDEX An index composed of secondary keys rather than 
primary keys* 

SECTOR The smallest addressable portion of storage on a diskette (a 
unit of 256 bytes on a TRS-80 diskette) . 

SEEK To position the access mechanism of a direct-access storage 
device at a specified location* 

SEQUENTIAL ACCESS Access in which records must be read serially or 
sequentially one after the other? i.e., ASCII files, tape* 

SINGLE PRECISION A positive or negative numerical value of 6 digits 
in lengthy not including a decimal point (EXAMPLE? 99999.9) * 

SORT To arrange a file or data in a sequence by a specified key (may 
be alphabetic or numeric and in descending or ascending order) „ 

SOURCE CODE The text from which code that may be executed is 
derived,, 

SYSTEM FILE A program used by the operating system to manage the 
executing program and/or the computer's resources, 

SUB-STRINGS SUB-STRING SEARCH See INSTRING 

TABLE A collection of data suitable for quick reference, each item 
being uniquely identified either by a label or its relative position,, 

TALLY To add or subtract a digit from a quantity. 

TOKEN A one byte code representing a larger word consisting of 2 or 
more characters. 

TRACK The circular recording surface traversed by a read/write head 
on the disk* On the TRS-80 a track contains 10 sectors (2 granules). 

TRANSACTION An input record applied to an established file. The 
input record describes some "event" that will either cause a new file 
record to be generated, an existing record to be changed or an 
existing record to be deleted* 

TRANSPARENT Complexities that are hidden from the programmers or 
users (made transparent to them) by the software. 

VECTOR A line representing the properties of magnitude and 
direction* Since such a 'line' can be described in mathematical 
terms, a mathematical description (expressed in numbers, of course) of 
a given 'direction' and 'magnitude 8 is referred to as a "vector",, 
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VERIFY To check a data transfer or transcription. 

WORKING STORAGE A portion of storage, usually computer main memory, 
reserved for the temporary results of operations. 

WRITE To record information on a storage device. 

ZAP To change a byte or bytes of data in memory or on diskette by 
using a software utility program. 

ZEROETH Zeroeth is to '0' as first is to '1'; in computer terms the 
first position of anything is usually described as the 'zeroeth' and 
the next position is the 'first' and so on. 
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PARTS LIST 

SIMPLE HOBBYIST INTERFACE 



PARTS LIST 

QUAD SOUND, BOOPS AND BLEEPS GENERATOR 



IG 



TYPE 



+5 VOLTS 



GROUND 



IC 



TYPE 



+5 VOLTS 



Z1 


81LS95 


Z2 


81 LS96 


Z3 


81LS9S 


Z4 


81LS95 


Z5 


74LS75 


Z6 


74LS75 


Z7 


74LS30 


Z8 


74LSD2 



SO 
SO 
20 
SO 
5 
5 
14 
14 



10 
1D 
10 
10 
12 
12 
7 
7 



Z1 
Z2 
Z3 
Z4 
Z5 



74LS374 
74LS1 25 
74LS30 
74LS3D 
7LS02 



20 
14 
14 
14 
14 



PARTS LIST 

ONE-SECOND INTERRUPT REAL-TIME CLOCK 



IC 



PART 



C1 
C2 
C3 
C4 



TYPE 



+5 VOLTS 



GROUND 



Z1 


7805 


Z2 


74LS14 


Z3 


74LS90 


Z4 


74LS92 


Z5 


74LS74 


Z6 


74LS75 



3 (OUTPUT! 


2 


Z1 


74LS30 


14 


14 


7 


Z2 


74LS02 


14 


5 


10 


Z3 


74LS00 


14 


5 


10 


Z4 


74LS00 


14 


14 


7 


Z5 


74LS1 25 


14 


5 


12 


Z6,7,8,9 


2114-AN4L 


18 






Z10 


2716 


24 



VALUE 



NOTES 



4700 mf, 16 volts 
220 mf, 16 volts 
100 nf (0.1 mf) 
100 nf (0.1 mf) 



PART 



VALUE 



NOTES 



R1-R16 



1kO [10,000 ohms) 



PARTS LIST 

MUSIC SYNTHESIZER INTERFACE BOARD 



GROUND 



10 
7 

7 
7 
7 



PART 




VALUE NOTES 




R1-R5 




1k (10,000 ohms) 




PARTS LIST 
MEMORY SIDECAR 


ROM AND RAM ADDITION 




IC 


TYPE +5 VOLTS 


GROUND 



7 
7 
7 

7 

7 

9 

12 



PARTS LIST 

HSM5832 REAL-TIME CLOCK/CALENDAR 



IC 



TYPE 



+5 VOLTS 



GROUND 



Z1 


74LS30 


Z2 


74LS260 


Z3 


INS8255 


Z4 


MSM5832 



14 

14 

26 

1 



7 

7 

7 

13 



PART 



VALUE 



NOTES 



C1 
C2 
C3 
C4 
C5 
C6 
R1-R12 



20 pf 




20 pf 




100 nf 


(0.1 mf) 


100 nf 


(0.1 mf) 


100 nf 


(0.1 mf) 


100 nf 


(0.1 mf) 


10k (10 


,000 ohms) 



Battery backup: 

PART VALUE 



NOTES 



C6 

C7 

C8 

C9 

D1 

D2 

01 

Q2 

R13 

R14 

R15 

R16 

T1 

Z5 



470 mf, 16 voLts 

10 mf, 16 volts 

100 nf (0.1 mf) 

10 mf, 16 volts 

Bridge rectifier, 1A 50V 

1N914 or equivalent 

PNP transistor, Vce=0.1 volt 

NPN transistor 

47k (47,000 ohms) 

10k (10,000 ohms] 

10k (10,000 ohms) 

100R (100 ohms), 0.5 W 

6V3 (6.3 volt), 1A transformer 

7805 5-volt regulator 



IC 



TYPE 



+5 VOLTS 



Z1 
Z2 
Z3 
Z4 
Z5 
Z6 
Z7 
Z8 
Z9 
Z10 



81LS95 

74LS154 

74LS00 

74LS04 

INSB255 



20 
24 
14 
14 
26 



MC1408L8 OR DAC080B 13 
MC1408L8 OR DACDBD8 13 
74LS123 14 

74LS123 14 

LM324 4 



GROUND 



10 
12 
7 
7 
7 
2 
2 
7 
7 
11 



Note that Z6 and Z7 also require -15 volts on pin 
number 3 and and +7.5 volt reference at pin 14 
(through a variabLe resistor). 



FART 



VALUE 



NOTES 



C1,2 20 pf 

C3,4,5,6 100 nf (0.1 mf) (may ba changed) 

R1,3 4k7 (4700 ohms) 

R2,4 1k0 (1000 ohms) (mey be changed) 

R5,6,7,8 1MD (1,000,000 ohms) 



PARTS LIST 

BANK-SELECT ROM/RAM ADDITION 



IC 



TYPE 



+5 VOLTS 



GROUND 



Z1 


81LS95 


20 


Z2 


81LS95 


20 


Z3 


81LS95 


20 


Z4 


81LS95 


20 


Z5-11 


2716 OR 4118 


24 


Z12 


74LS20 


14 


Z13 


74LS260 


14 


Z14 


74LS02 


14 


Z15 


74LS75 




Z16 


74154 


24 


Z17 


74LSD4 


14 


Z18-26 


2716 OR 4118 


24 



10 

10 

10 

10 

12 

7 

7 

7 

12 

7 

12 
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PARTS LIST 

6-TRACK MASS STORAGE SYSTEM 



FARTS LIST 

4K DYNAMIC RAM ADDITION 



IC 



TYPE 



+5 VOLTS +12 VOLTS GROUND 



Z1 

Z2 

Z3 

Z4 

Z5 

Z6 

Z7 

Z8 

Z9 

Z10 

Z11 

Z12 

Z13 

Z14 



70C98/60C98 

74LS04 

74LS1 25 

LF353 

LM339 

70C98/BOC9B 

LF353 

74LSDQ 

75452 

70C96/80C96 

75452 

74LS373 

74LS30 

74LS04 



14 
14 



14 



20 
14 
14 



7 
4 

4 

10 

7 

7 



PART 



VALUE 



NOTES 



C1 

C2 

C3 

C4 

C5 

CB 

C7 

C8 

09,10,11 

C12 

01,2,3,4,5 

K1.2.3 

R1,2,14,17, 

18,30,38,39, 

40,41 
R3 ,4,12,19, 

20,28 
R5, 6,9,11, 16, 

22,25,27,32 
R7,8,23,24 
R10.26 
R13.29 
R15.31 
R33 ,34,35 ,36, 

37,42 
R43 
R44 
S1 
S2 
S3 



100 pf 

220 pf 

220 nf (0. 22 mf) 

10 mf, 16 volts 

100 pf 

220 pf 

£20 nf (0.22 ».f J 

10 mf, 16 volts 

100 nf (0.1 mf) 

470 mf, 35 volts 

1N914 or equivalent 

Miniature SPST 5-volt relay 



10k (10,000 ohms) 

470R (470 ohms) 

2k2 (2200 ohms) 
220k (220,000 ohms) 
100k (100,000 ohms) 
22k (22,000 ohms) 
220R (220 ohms) 

1k0 (1000 ohms) 

100R (100 ohms) 

75R (75 ohms) May need adjustment 

Cartridge-in-place leaf switch 

Track change Light switch 

Split-pole foil sensor switch 



IC 




TYPE 


+5 


VOLTS 




GROUND 


Z1 




81LSS5 




20 






10 


Z2 




74LS157 




16 






8 


Z3 




81LS95 




20 






10 


Z4 




74LS1S7 




16 






U 


Z5 




81 LS95 




20 






10 


Z6-13 




MK4114 4K RAMS 




9 






16 


Z14 




74LS20 




14 






7 


Z15 




74LS86 




14 






/ 


Z16 




B1LS95 




20 






1U 


Note 


that 


Z6 through Z13 a 


Iso require 


-5 vo 


Us 


on 


pin number 


1 and +12 volts 


on p 


in number 8. 






FART 




VALUE 




NOTES 






R1.2, 


,3 


1k0 (1000 ( 


ahms) 










S1 




4-position 


DIP 


switch 









PARTS LIST 

HIGH-SPEED, REVERSE VIDEO, UPPER/LOWER CASE, 

INDIVIDUAL REVERSE VIDEO MODS 



IC TYPE 


+5 


VOLTS 




GROUND 


F45 (ZMEM) 2102-4L 




10 




S 


P25 (ZBITS) 74LS10 




14 




7 


P6 (ZFAZE) 74LS04 




14 




7 


P27 (ZMODE) 74LS368 




20 




10 


P24 (ZMUXX) 74LSB6 




14 




7 


P26 (ZFLOP) 74LS74 




14 




7 


P53 (ZPORT) 74LS02 




14 




7 


P44 (ZFAST) 74LS367 




20 




10 


PC VERSION ONLY: 










Z25 74LS04 




14 




7 


FART VALUE 






NOTES 




C1 330 pf 










C2 33 nf ( 


.033 mf: 


I 






R1 10k (10,000 ohms) 






VCR1 100k (100,000 ohms) 


Varia 


ble 



Miscellaneous: 

One 16-pin wire-wrap integrated circuit socket for 

piyyybackiny the PC board version onto Z45. 

No socket is needed for the hard-wired version. 



FARTS LIST 

MICRO FRONT PANEL MONITOR 



IC 



TYPE 



+5 VOLTS 



Z1 


74LS373 20 


Z2 


74LS373 20 


Z3 


74LS373 20 


Z4 


74LS20 14 


PART 


VALUE N( 


0IS1 ,2,3 


10-seyment bar LED 


LED1-24 


Subminiature LED 


R1-24 


270R (270 ohms) 


R25,26,27 


,28 1k0 [1000 ohms) 


S1 


4-position DIP switch 



GROUND 



10 

10 

10 

7 



NOTES 



PARTS LIST 

HIGH-RESOLUTION GRAPHICS BOARD 

POWER SUPPLY 



PART 



C1 
C2 
C3 
C4 
C5 
C6 
C7 
CB 
C9 
R1 



VALUE 



NOTES 



4700 mf, 35 volts 
100 mf, 25 volts 
10D nf [0.1 mf) 

10,000 mf, 35 volts 
100 mf, 16 volts 
100 nf (0.1 mf) 
470 mf, 16 volts 
100 mf, 16 voLts 
100 nf (0.1 mf) 
220 ohms, 1/2 watt 
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PARTS LIST 

HIGH-RESOLUTION GRAPHICS BOARD 



IC 


TYPE 


+5 VOLTS 




GROUND 


Z1 


74LSD4 




14 






7 


Z2 


74LS92 




5 






10 


Z3 


74LS74 




14 






7 


Z4 


74LS93 




5 






10 


Z5 


74LS93 




5 






10 


Z6 


74LS93 




5 






10 


Z7 


74LS93 




5 






10 


ZB 


74LS11 




14 






7 


Z9 


74LS02 




14 






7 


Z10 


74LS157 




1B 






8 


Z11 


74LS157 




1B 






8 


Z12 


74LS157 




1B 






8 


Z13 


74LS1 57 




16 






8 


Z14 


74LS74 




14 






7 


Z15 


74LS00 




14 






7 


Z16 


74LS174 




16 






8 


Z17 


74LS166 




16 






8 


Z18 


74LS157 




16 






8 


Z19 


74LS157 




16 






8 


Z20 


74LS157 




16 






8 


Z21 


HK411S 




9 






16 


Z22 


MK4116 




9 






16 


Z23 


MK4116 




9 






16 


Z24 


MK4116 




9 






16 


Z25 


MK4116 




9 






16 


Z26 


HK4116 




9 






16 


Z27 


74C04 




14 






7 


Z2B 


74C04 




14 






7 


Z29 


74C00 




14 






7 


Z30 


75452 




8 






4 


Z31 


74LS00 




14 






7 


Note that 


Z21 through Z26 


also 


need 


-5 


volts on pin 


number 1 , 


and +12 voLts on 


pin 


number 6 


I. 




PART 


VALUE 






NOTES 




C1* 


47 pf 




Miniature vari 


abLe 


C2 


10 nf (.01 


mf 3 










C3 


10 mf, 16v 












C4 


330 pf 




10% 


or 


better 




C5 


47 nf (.047 raf) 


10% 


or 


better 




C6 


750 pf 




10% 


or 


better 




C7 


£2 nf (.022 mf) 


10% 


or 


better 




Q1 


2N3904 




NPN 


switching 




0.2 


2N3904 




NPN 


swi 


itching 




R1 


1k0 (1000 


ohms) 










R2 


1k0 (1000 


ohms) 










R3 


1k0 (1000 


ohms) 










R4* 


S10R (910 


ohms) 










R5* 


S10R (910 


ohms) 










RB 


1k8 (1B00 


ohms) 










R7 


47R (47 ohms) 










RB 


270R (270 


ohms) 










R9 


120R (120 


ohms) 










R1Q 


330R (330 


ohms) 










R11 


75R (75 ohms) 










R12 


10k (10,000 ohn 


is) 








R13 


10k (10,000 ohms) 








VCR1 


100k (100 


,000 ohms) 


VariabLe 




VCR2 


100k (100 


,000 ohms) 


Variable 




X1* 


10.6445 MHz 










*Not needed if computer's 


internal 


clock is used. 
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MUSIC SYNTHESIZER INTERFACE BOARD 
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by H. C Pennington 



TRS-80 Disk and Other Mysteries is the definitive fix-it book for disk users. 
More than 130 pages of easy to read entertaining and immensely useful 
information. Find out how to recover disk files, the layout of information 
on disks, memory maps, problem solutions ... the list goes on! 

Many readers have saved days of work by recreating disk files that were 
unreadable. TRS-80 Disk and Other Mysteries, which has received 
favorable reviews in several magazines, is yours for only $22 .50 (plus $3 .00 
shipping. CA residents add $1 .35 sales tax. Canada add 20% for exchange 

rate.) TRS-80 is a trademark of Tandy 
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by James Farvour 

Microsoft Basic and Other Mysteries is the definitive guide to your Level 1 1 
ROMs. With more than 7,000 lines of detailed comments and 6 additional 
chapters packed with information, it is easily the biggest and best book 
about the Level II ROMs available. 

Exploit the full power of Microsoft Basic with the aid of more than 300 
pages of tested examples, explanations, and detailed comments. Microsoft 
Basic and Other Mysteries is yours for only $29.95 (plus $3.00 shipping. 
CA residents add $1 .80 sales tax. Canadaa add 20% for exchange rate.) 

* TJVI. Microsoft 
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AND BETTER 



by Lewis Rosenfelder 

Basic is not nearly as slow as most programmers think. Basic Faster and 
Better shows you how to supercharge your BASIC with almost 300 pages 
of fast, functions and subroutines. 

You won't find any trivial poorly designed "check-book balancing" 
programs in this book— its packed with useful programs. 

Tutorial for the beginner, instructive for the advanced, and invaluable for 
the professional, this book doesn's just talk ... it shows howl All routines 
are also available on disk, so that you can save hours of keyboarding and 
debugging. 

The #1 disk BFBDEM contains all the demonstration programs, and 
#2 disk BFBLIB has all the library functions. 

Basic Faster and Better is $29.95, and the two disks are $19.95 each 
(plus $3.00 shipping for book and disks together or separate. CA residents 
add $1 .80 sales tax for the book, disks add $1 .20 each. Canada add 20% 
for exchange rate.) 




ISBN 93620<H>2 



